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LASER BARRIER 
BROKEN 

Historic first: Amiga creates 
typesei qualityjextwithlaser printer 



You are reading history- You are 
reading the first published examp- 
les of typeset quality, laser printed 
words created on a desktop pub- 
lishing program for the Com- 
modorl Amiga. Yesterday « .** 
impossible. Today, it's within ev- 
ery Amiga owner's reach with 
Sid Disk's PageSetter 1.0 Desk- 
top Publishing Software and he 
breakthrough new PageSetter 
LaserScript program. Reports, 
forms, flyers, and even newspapers 
can be created with a whole new 
level or professionalism. 

PageSetter LaserScript adds an 
exciting new dimension to the al- 
ready powerful PageSetter 1.0. In 
addition to providing the four most 
popular laser typefaces (with more 

on the way), PageSetter Laser- 
Script gives you complete control 
over type style and size. It also 
frees you to change the position 
and size of entire pages, including 
the power to rotate them if you 
want There's even an option to 
create custom templates, a time- 
saving feature the frees you from 
repetitious formatting and re-for- 
matting. And it works with any 
PostScript laser pnnter. 

"PageSetter LaserScnpt is just 
the beginning of a series of break- 
through desktop publishing pro- 
grams from Gold Disk", reported a 
company spokesperson We are 
committed to making the Amiga 
the premier desktop publishing ma- 
chine, and we have products m de- 



velopment that are going to do just 
that" A reliable inside source re- 
ports that a big announcement is 
due in the near future. 

Prices are extremely competi- 
tive PageSetter 1.0 remains priced 
at $149 95, while the new PageSet- 
ter LaserScript will be priced at 

In related news, Gold Disk also 
announced the availability ot a 
special disk containing over 25 
fonts for dot-matrix printers in- 
cluding the Times, Helvetica and 
Courier typefaces. Gold Disk is 
calling their new product FontSet 1 
and is pricing it at $34.95. 




EMERGENCY 

TELEPHONE 

NUMBERS 

SET UP TO COPE 

WITH DEMAND 

Gold Disk Inc has set up emer- 
gency telephone numbers to help 
inxious Amiga owners locate their 
nearest PageSetter 1.0 retailer 

"Anyone in the continental Unit- 
ed States can reach us tou-ftee 1- 
800-387-8192", said a Gold Disk 
spokesperson. "All other callers 
should dial 1-416-828-0913" Cus- 
tomers can also reach Gold Disk by 
addressing mail to: Gold Disk inc, 
P.O. Box 789, Streetsville Ontano, 
Canada, L5M 2C2 
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PageSetter 1.0 
The Only Choice 

For Serious 
DesktopPublishing 

No olherprogram 
co mes clo se 
Amiga owners don't need a 
laser printer to take advantage of 
the power and simplicity of Page- 
Setter 1 0. All that's needed is an 
Amiga compatible dot-matrix 
printer. A truly intuitive user inter- 
face makes page design a snap, in 
the normal mode, what you see on 
the screen is exactly what you get 
when you print out the page You 
can also pull back to view the en- 
tire page, or zoom in to edit up 
close There are even a vanety ot 
borders, shadows, and shading pat- 
terns to choose from. PageSette 
1 is a fully integrated page layout 
program. You can create your doc- 
uments with the built-in word pro- 
cessor, or create graphics in the 
built-in graphics editor. Of course 
you can always import document 
and drawings from other Amig 
programs like TextCraft, Scribble! 
Deluxe Paint or Aegis Images. 
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Specification 



Maximum field size... 10 Megabytes 
Maximum no. of fields to a record. ..10,000,000 
Maximum no., of records toa file... 100,000,000 
Maximum size of a fife... 1 Gigabyte 
Maximum level of sorts... 65,000 
Maximum level of selection criteria... 65,000 
Maximum number of files in a system... unlimited 
Maximum no. of paths attached to one file... 1 6 
Data types: alpha/numeric, date, time, logical 
Field formats: standard IFF picture, customised 
Database language functions... over 200 

System requirements: Amiga with at least 51 2K 
RAM and 2 floppy disk drives or a hard disk. 



Features 

TRULY RELATIONAL 

Multiple databases can be opened and linkec 

together simultaneously on screen 

STORE DOCUMENTS PICTURES DATES TIME5 AND 

CALCULATIONS. 

NEARLY 200 COMMANDS AND FUNCTIONS IN Acom 

has its own programming languageforthe ultimate in 

flexibility 

CUT AND PASTE WITHIN FIELDS PROMPTS 

manipulate data within a field and transfer to other 

fields, recordsor databases usi ng f he powerful cut and 

paste feature 

REPORTGENERATOR 

full function report generator allows selection across 

the entire filing system uses built-intext processor or 

any word processor 

GRAPHIC BACKDROP 

load in graphic images to act as a base screen to hold 

your data fields - very userfriendly. 
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HAITSX 



Distributed in Australia by: 

COMMODORE AUSTRALIA 

67 Mars Road, Lane Cove 

New South Wales 2066, Australia 

Distributed in the USA by : 

Haitex Resources 

208 Carrollton Park ■ Suile 1207 

Carrollton, Texas 75006 

(214) 241-8030 



Distributed in Sweden: 
FORLAGSGRUPPEN Nygatan85 
602-34-NORRKOPING 
TEL; 011 13 4080 

1 .2 KICKSTART 512K & 2 DRIVES 

* AMIGA is a trade mark 
of Commodore Machines 

Cirde 302 or Reader Service card. 



Produced by 
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IMPEX LTD. 

Taurus House, 3 Bridge Street, Guildford 

Surrey GU1 4RY. Telephone: Guildford (0483) 579399. 

Telex: 859500. Facsimile No: (0483) 502048. 
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Unbeatable SCSI Flexibility: No 

other Ainiga hard drive can offer 
you: Capacities from 20MB to 
760MB... plug-in compatibility with 
optical (WORM) drives, removable 
cartridge drives & CD ROMs... op- 
tional networking capability... dual 
drive compatibility with ST506 and 
add-ons, allowing use of up to 14 
hard drives with your Amiga! 
A REAL Track Record: C Ltd 



has been shipping Amiga hard 
drives since November, 1986. With 
thousands of units in use, you can 
count on C Ltd's proven hardware 
& software reliability. 

Circle 301 on Reader Service card 



Extraordinary Support: Call our 
technical support line, and you talk 
to the people who actually build 
the C Ltd products. Each drive is 
supplied with a complete technical 
manual. Each drive is fully formatted , 
with 10 MB of useful public do- 
main software and commercial 
demo programs. 




Cheaper By The Megabyte. 
The more megabytes you buy, the 
less each magabyte costs you! 



■ 



22MB 
33MB 
44MB 
50MB 
60MB 
80MB 
150MB 






g 999 95 

1249.95 

1499.95 
i 599 95 

1999.95 
2499.95 
3299.95 



additional sizes up to 750MB avail- 
able upon request. 



The Industry's Longest 
Warranty 

One-year parts & labor warranty. 

AMIGA is a registered trademark of Commodore-AMIGA, fnc. 



T23 East Skinner Wichita. Kansas 6721 I I3W) XT-3807 
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El Zeitgeist 

Bob Ryan — who we hold mostly responsible 
for this Special Issue— explains the whys 
and wherefores. 



Tips and Techniques 

By AmigaWorld Readers 

Ideas, notions, advice and serendipitous rev- 
elations from the clever readers of Amiga- 
World, as seen in our tasty Ilors d'oeuvres 
column. 

Beginner's Guide to the CLI 

By Peggy Herrington 

There's more to life than icons, and the 
Command Line Interface isn't as frighten- 
ing as it sounds. 

IFF: The Standard of Sharing 

By Louis Wallace 

Though IFF is a buzzword in the Amiga 
community, for many its meaning remains a 
mystery. . . that is, until now. 



BASIC Intuition 

By Bryan Catley 

Use custom windows and menus to create 
professional-looking Amiga Basic displays. 



Tangible Graphics 

By AmigaWorld Editors and 
Friends 

Capturing Amiga screens on paper, film 
and videotape. 

AmigaWorld Technical 
Reference Guide 

A helpful, handy special pull-out reference 
section that has everything from printer de- 
vice command functions and CLI and BA- 
SIC commands and error codes to 
hardware locations and those mystifying 
Guru Meditiation numbers. A near-necessity 
for the Amigaphile's coffee table or night- 
stand! 



Arrivals and Departures: 
Input, Output and C 

By Vincent M. Hopson 

Learn to access printers, disk drives and 
other peripherals from your C programs. 

Where Things Get Done: 
An Overview of Workbench 

By Vinoy Laughner 

A beginner's introduction to Workbench, 
with a more specific sidebar on using the 
Icon Editor. 
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Executive Control: 

Introduction to the Amiga's Kernel 

By David T.McClellan 

Behind the Amiga's multitasking software 
flexibility and ease is a group of complex 
and powerful low-level routines — the Exec. 



AmigaWorld {ISSN 0S83-SS90) is an independent journal not connected with Commodore Business Machines. Inc. AmigaWorld is published bimonthly by CW Communications/Peterborough, Inc.. 80 E!m 
St. Peterborough. NH 03458. U.S. subscription rale is $19.97. one year. Canada and Mexico $22.97. one year. U.S. funds drawn on U.S. bank only. Foreign Surface $39.97. Foreign Air Mail $74.97, U.S. 
funds drawn on US. bank. Phone 603-924-9471. Entire contents copyright 1986 by CW Communications/Peterborough, Inc. No part of this publication mav be primed or otherwise reproduced without 
written permission from the publisher. Pommnster; Send address changes lo AmigaWorld. Subscription Services, I'O Box 954, Farmingdale. NY 1 1 735. Nationally distributed by Internationa! Circulation Distributors. 
AvagaWorld makes every efTort to assure the accuracy of articles, listings and circuits published in the magazine. AmigaWorld assumes no responsibility for damages due to errors or omissions. 
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URBO TOWER 

Improves 

Amiga 
Performance. 
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We've redesigned our turbo chassis into a new and improved 
Turbo Tower to keep pace with the changes in the industry. 

Four enhancements have been added to provide you with 
improved performance from CSA's 68020/68881 award winning 
CPU board 

• Expanded chassis to accommodate Amiga and IBM compati- 
ble flex form cards. 

• Local area network interface with other Amigas and 
workstations. 

• Turbo Tower design provides flexible and convenient work- 
station capability. 

. CSA boards also lit new Amiga A20Q0 . 

Designed to meet me changing features of the Amiga and now 
with IBM compatibility. 

"Put a Turbo on the Porsche ot Personal Computers." 

Starting from 53870.00 (domestic price) 

options available 

As seen in the March 1987 Commodore Magazine front cover. 
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THINK OF IT A 
OUR AMIGA'S AMI 




Introducing Xebec's 9720H 
Storage Subsystem. 
Because High Performance 
Computers Need High 
Performance Companions. 

Okay, so you've got all of this great 
stuff on your Amiga. Now where are you 
going to put it? A smart place would be 
our place. The handsome, 20-megabyte 
Xebec 9720H standalone subsystem. 
Built to the highest quality standard in 
the industry. Spaced specifically to meet 



the design criteria 

and to enhance the 

multitasking capabilities of AmigaDOS. 

And totally compatible with AmigaDOS 

KickStart. 

The Xebec 9720H. A high performance 
companion to your high performance 
Amiga. At an impressively low price. Just 
$1095.00. Call 800-982-3232 for the 
Amiga dealer nearest you carrying the 
Xebec 9720H. 




The Zero Defect Company 



3579 Highway 50 East 
Carson City, Nevada 89701 
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* Announcing the 
. 'fi^st great AMIGA 
get-together! . 



AmigaWorld Expo 

September 11-13, San Francisco 



with the thousands of Amiga lovers in a hands-on festival of this remarkable 
^^computer. Experts and enthusiasts who understand the Amiga and its 
impact on business, the arts, science, music, education and at home. 



The first show of its kind devoted 
to the Amiga, with special confer- 
ences, exhibits and hands-on dis- 
plays of the Amiga 1000. Plus your 
chance to try out the new Amiga 
500 and 2000! 




; you own, lease, use or are 
thinking of buying an Amiga, this 
show is for you. 

Now you can learn everything you 
want to know about Amiga in one 
place. If ]J|i re thinking of buying, 
this is the show for you. Or, if you 
already own one, expand your 
knowledge and meet thousands of 
other owners, all under one roof. 

Meet an Amiga face to face. See 

the stunning graphics, hear the 
awesome stereo sound, experience 



the range of multi-tasking capabili- 
ties — there'll be plenty of Amigas 
to play with. 

Evaluate and compare Amiga 
products. Talk to the exhibitors 
that produce hardware, software 
and peripherals for the Amiga. 
See the latest in Amiga-related 
technology. 

Learn from the Amiga experts. 

Register for special beginner and 
advanced conferences, and meet 
the people who best understand 
Amiga's current and potential 
applications. 

You've got a friend at 
AmigaWorld Expo! Sponsored 
by AmigaWorld Magazine and 
supported by Commodore 
International. 



For more information fill out the coupon 
below and send it to: Mitch Hall Asso- 
ciates, P.O. Box 155, Westwood, MA 02090. 
For exhibitor's information call: 

(617) 329-8334 



The AmigaWorld Exposition is produced by World Expo Co. and managed by Mitch Hal! Associates. For 
further information call Mitch Hall Associates at (617) 329-8334. AmigaWorld Exposition is a registered 
trademark ol World Expo Co. Inc. AmigaWorld is a trademark of CW Communications/Peterborough. 
Amiga is a registered trademark of Commodore International. 
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YES! I'm interested in joining the 
thousands of Amiga lovers at the first 
AmigaWorld Expo on September 11-13 at 
Brooks Hall/Civic Auditorium in San 
Francisco. Please send me more informa- 
tion and details on your preregistrntion 
discounts. 



Name 



Address 



City 



State Zip 
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You Told Us What The 
Best Computer Baseball Game 

Would Have 



"Great graphics" 



"Relief pitchers 
—and subs" 



"I like to slide 
—even head first 



"Let me see what's happening 
on the whole field." 




I want to play in the series!" 



"I want to be able to throw 

a lot of different pitches." 



"Put me right at the plate 
when I'm batting." 



CHAMPIONSHIP BASEBALL 

With 4 Divisions, 24 Teams, Playoffs and a Championship Series 



You've been asking for the best in 
computer baseball games, and you 
want it all— graphics and features. 
We've heard you, and Gamestar's 
Championship Baseball delivers. No 
other product gives you the complete 
sport of baseball like Championship 
Baseball: 

• Player Draft, complete with reserves. 

• Setting your starting lineup. 

• Batting Practice, Exhibition Game 
and League Play options. 

• Each division is tougher than the last, 
so there's always a new challenge. 
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BASEBALL 




• You control all the action on the 
field— pitching (8 different pitches), 
hitting, catching, outfield relays, base 
running, even sliding under tags. 

• Player substitutions can be made 
throughout the game. 

• Division, playoff and championship 
series play. 

All this and much more in the most 
complete baseball program available. 
When you're ready to step into the 
major leagues of computer baseball, 
Championship Baseball's your ticket. 
Nobody else gives you more. 



For IBM PC, Tandy 1000, Apple lie, nc, Commodore 64/128, Amiga, Atari ST and 100% compatible computers. 

To order, visit your local retailer or call 1-800-227-6900 
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Select jour platers from the lalent 
pool, based on their characteristics 
and skill ratings. Name them after 
todays stars. or anyone you want. 



Batting window disappear, when the 
hails in play, so you can see continuous 
action. 



Determine the batting order that will 
have the best chance against your 
opponent 

Amija screens showntolhcr systems may vary. Commodore 64. I28ami Amieaare trademarks of Commodore Electronics Limited 
IBM is a trademark of International Business Machines Corporation. Tandy is a trademark ofTandy Corporation. Atari and ST are Iradcmarksof A! ari Corporation. Apple is a trademark ofApplc Computer. 
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What's So Special? 



By Bob Ryan 

No, Guy hasn't been kidnapped by a band of crazed 
typesetters, nor has he absconded to Rio with last 
month's subscription receipts. He simply thought it 
would be a good idea if the Technical Editor wrote the 
editorial for this Special Issue of AmigaWorld. 

You'll notice a lot of unusual things about this edi- 
tion of AmigaWorld. Much of the normal editorial con- 
tent is missing — no new product listings, no reviews, 
not much of anything that constitutes a regular issue. 
We intentionally left those (and more) out, because we 
wanted to limit the amount of time-sensitive material in 
this issue; we hope you'll keep this copy by your com- 
puter for a long time, and refer to it often. 

While producing the Special Issue, we came to think 
of it as "a beginner's guide to everything." We chose the 
articles published here because they're all good intro- 
ductions to different aspects of the Amiga system. 
Depending upon your level of expertise, you may enjoy 
"Beginner's Guide to the CLI," "BASIC Intuition," or 



perhaps "Executive Control: Introduction to the Ami- 
ga's Kernel." We think everyone will like the pull-out 
Technical Reference Guide bound into the issue; it 
brings useful information from many different sources 
together in one handy package. (Some of the staff 
didn't find the listings of hardware locations terribly 
useful, but I think they're neat.) The only holdover 
from our regular issue is Tips and Techniques: all the 
best from AmigaWorld' s Hors d'oeuvres column. In addi- 
tion to reprinting and reorganizing tips from past 
issues, we've included a lot of new material as well. 

The AmigaWorld Special Issue is a beginner's guide in 
another sense, too: It's the first time I've had executive 
responsibility for a magazine. I had a lot of fun bug- 
ging the other editors about deadlines (that's a switch) 
and working closely with the talented people in the 
AmigaWorld art department. If enough people enjoy this 
Special Issue (as I hope you will), the folks upstairs 
might just let us do it again next ycar.B 



DESIGNTEXT: Word Processing That Means Business! 



ULTIMATE SPEED & EASE 



USER ORIENTED 



•Gadgets, Menus, or AMIGA Key 

operation. 
•FAST Scrolling (Line/Screen/Page or 

Slider). 

• Horizontal Scrolling with lull 80 character 
display. 

• Multiple Columns. 

• Multiple documents/windows- 
•Taoular input ol figures 
•Multiple lonts 

• Semi- Automatic Hyphenation. 
•Also works in Interlace Mode. 



FORMATTING OPTIONS 



•Graphic Import Ability. 

• Borders. Separating Lines and Titles 
•Outline Summary. 

• Hard and Soft page breaks 
•Headers and Foolers 
•Automatic Index Generation 
•Automatic Footnote Generation. 

• Nob sequential page printing 



PEOPLEBASE 



• Fully Integrated with DesignTexl. 

• Form Letter Generation. 

• Client contact update. 
•Multiple Search Criteria 
•Address List printing. 

• Little Black Book generation. 

• Mailing Label Printing 

• File security. 



EXTRAS 



-up 



• Special drivers lor popular pnnters- 
10 292 Dots/inch 

• Supports all storage devices. 

•Able to load TextCratt and Scribble tiles 

• Ability to chain multiple tiles, 

• Full Search and Search/ Replace options. 
•Integrated Spelling Checker. 
•Optional Terminal Modules 

• Math (unctions 




■DESIGNTEXT (tm) 

— GADGETS 

LARGE TITLES 

GRAPHICS 

COLUMNS 

~* FULLY 

-^INTEGRATED 
PEOPLEBASE (tm) 

SEARCHABLE 

COMMENT 

FIELDS 

SCROLLING 
RECORDS 



NOW! $50.00 
EARLY ORDER 
DISCOUNT: 
Reg. $129.00 




DESIGNTEXT 

byDESIGNTECH 



Cheque or DESIGMTECH DEALER 

Money Order to: Business Systems Inc. INQUIRIES 

($79.00 U.S. Each) 304. 850 Burrard St. iwi//Tcn 

Vancouver, B.C. iNVittu 

Canada V6Z 2J1 Phone (604) 669-1855 
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The start of a perfect 
friendship. 




WordPerfect for the Amiga' 

If you've been looking for a truly full-featured word 
processor that maximizes the capabilities of your Amiga, 
then meet WordPerfect. The same power and features that 
have made WordPerfect the best seller for IBM PCs are now 
available in a specially designed version for the Amiga 
computer. 

A True Professional. 

Regardless of your needs, WordPerfect offers you 
professional features to make your job easier and increase 
your productivity". 

In the office, WordPerfect lets you automate time-consum- 
ing tasks, streamline difficult work, and maintain even the 
largest documents. At school, you can focus on what you* re 
saying while WordPerfect handles the formatting. Even for 
uncomplicated tasks at home, WordPerfect produces 
professional quality results with simplicity and elegance. 

WordPerfect bends to the most creative imaginations and 
most demanding tasks by offering such useful features as: 
Automatic Footnotes/Fndnotes 'Table of Contents 
* Indexing * Paragraph/Outline Numbering • Macros 



• Mail-Merge • Math Columns (with Four-Function Math) 

• File Management'Thesaurus* 115,000-word Speller'Text 
Columns. 

A Perfect Match. 

WordPerfect for the Amiga fully supports the Amiga 
interface, including pull-down menus and mouse control. 
Both the mouse and the function keys give you complete 
access to ail WordPerfect features. And, as you'd expect, 
WordPerfect takes advantage of the Amiga's multi-tasking 
capabilities. 

In addition, the Amiga version of WordPerfect offers file 
compatibility with WordPerfect 4.1 for the IBM. 

Friends For Good, 

So find out what full-femircd really means, and get 
acquainted with WordPerfect. You' 11 be amazed to see hmv 
friendly a professional word processor can be. For more 
information, call or write WordPerfect Corporation. 288 West 
Center St., Orem, Utah 84057 (801) 225-5000. 

\\brd Perfect 

CORPORATION 



AMIGA is j trddniurk of C'oninmdoic-Atnigy. Inc. 



Circle 308 on Reader Se-wce card. 




Amiga Tips And 
Techniques 

'deas, notions, advice and serendipitous revelations from 
the clever readers q/"AmigaWorld, as seen in our tasty 
Hors d'oeuvres column. Here they are, toothpicks and all. 



Workbench 

Scrambled Snapshots 

I have found that my icons are stacked 
and scrambled even after I have cleaned 
them up and used Snapshot. I finally 
tracked the problem down; it appears that 
if any of the files are write-protected, you 
may get unpredictable Snapshot results. 
You would think that only the write-pro- 
tected file icons wouldn't move, but this 
seems not to be the case. 

Robert L. Pleatman 
Cincinnati, OH 

Saving Custom Icons 

When I discovered how to use the Icon 
Editor on the Workbench disk, I made use- 
ful icons for my Amiga Basic programs. 
However, when I made an adjustment in 
the program and resaved it, my custom icon 
was replaced with the standard flow-chart 
icon that is created for every Amiga Basic 
program when it is initially saved. 

There are two solutions to this problem. 
One is to keep an icon library and use the 
Icon Editor to replace the standard icon 
with your custom icon. 

The other solution is implemented with- 
out leaving Amiga Basic, and leaves you 
with an old (unmodified) copy of the 
program. 

First, get into the intermediate mode and 
type SAVE OLD. Now you have a new copy 
of the program with a standard icon and an 
old copy of the program with your custom 
icon. All you have to do now is switch the 
programs. 

In the intermediate mode, type: 

NAME OLD AS TEMPORARY 
NAME your program 's name AS OLD 
NAME TEMPORARY AS your program's 



Now you have the new program with the 
custom icon and the old program with the 
standard icon, so you can move the old 
copy somewhere else or into the trash until 
you know your modifications work 
correctly. 

Derek Buckley 
Spokane, WA 

Icon Assortment 

Like many, I am slowly learning the nu- 
ances of the Amiga's operating system — the 
hard way. Handling Icons seems to be 
shrouded in mystery. Here are some hints; 

1) When copying files from the CLI use; 

COPY filermmeU} TO destination 

The #? wildcard characters insure that the 
filenarne.mfo (which contains the icon infor- 
mation) is also copied. 

2) If you create a directory from the CLI, 
an icon is not automatically generated for 
you. You can use the COPY command to 
"clone" an icon using: 

COPY drawer.info TO destination directory/ 
filename, info 

This makes a copy and changes the name at 
the same time. 

3) If you have project files (like Textcraft 
documents. Notepad notes, BASIC pro- 
grams, etc.) without icons, you can create 
icons for them by loading them into their 
tools (programs) and then resaving them. 
To load a program with a file from the CLI, 
type the program name followed by a 
space, and then the filename, e.g., UTILI- 
TIES/NOTEPAD filename, or TEXTCRAFT 
filename. 

4) Programs (tools) without icons repre- 
sent more of a challenge. A couple of excel- 
lent public-domain utilities are available to 
do this (such as IconExec) that will create 



bootable icons for most programs and DOS 
batch files. 

5) One last CLI note. I like to be able to 
identify non-standard C directory com- 
mands that I have collected by capitalizing 
their names, but the AmigaDOS RENAME 
command won't work to just change case. 
The simple solution is to rename the com- 
mand as something else, then rename it 
back to what you want in the case you want. 

Frank Turner 
Santa Cruz, CA 

Icon System Solution 

If you put Amiga Basic in a drawer, the 
Amiga won't find it when you try to open it 
by clicking on a BASIC program icon, un- 
less you change Amiga Basic's default loca- 
tion. Here's how: 

With Workbench loaded, first click once 
on the icon for the BASIC program. Next, 
select Info from the Workbench menu by 
highlighting it and releasing the mouse but- 
ton. When the Info window comes onto the 
screen, change the default tool from :AMI- 
GABASIC to :your drawer- namelAMlGA- 
BASIC. This will direct the Workbench to 
load Amiga Basic from the drawer. I tried it 
and it works for me. 

Dr. Michael J. Doyle 
Bel Air, MD 

RAM Disk Icons 1.2 

One of the many nice additions in the 
version 1.2 release of AmigaDOS is an icon 
for the RAM disk. The icon is generated 
when you first access the RAM: device from 
the CLI. This icon does not automatically 
appear when you boot on a normal Work- 
bench disk, but you can make it do 
so by adding the line DIR RAM: to the 
startup-sequence. 

The RAM: device is empty when you 
boot, so this command does nothing but >■ 
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The Mirror Copier Can Now Back Up 
A Disk Almost As Fast As Marauder II, 

And It Only Costs About 25% More! 



Marauder II Is the most 
powerful copier ever produced 
for Amiga. It will auto- 
matically copy ALL software 
released to date , and it 
requires no hardware 
modification of any kind. 
It produces completely 
unprotected copies of most 
Amiga software faster and 
better than any other copier. 



No other copier can copy 
as much software as 
Marauder II. 

Marauder n also has the most 
advanced user interface your 
money can buy. If you have 
an Amiga you already know 
how to use Marauder n. You 
never have to reboot your 
machine to use Marauder II, it 
is completely compatible with 



the Amiga's multitasking 
operating system. 

Marauder II has been designed 
with your future needs In 
mind, As protection schemes 
change you can update the 
program yourself with our 
unique "Strategy Files." 
The Strategy Files are 
developed as new software is 
released so that you can get 
them quickly and easily when 
you need them. 

Compare the features of 
Marauder II to our 
competition and you'll see 
that Marauder II is quite 
simply the best copier you can 
get, at any prlcel And for only 
♦39.95 you can rest assured 
that your software investment 
is safely protected against 
damage, loss or theft. 
Don't wait, order now! 




Duplication Speed 


83 Sec. - 


Upgradable With 
Strategy Files 


YES 


Mouse Driven User 
Interface 


YES 


Exit Without 
Restarting Amiga 


YES 


Runs From 
Workbench or CLI 


YES 


Makes Multiple 
Simultaneous Copies 
From One Original 


YES 


Copies Itself 


YES 


Copies The Mirror 


YES 


Price 


$39.95 



1 Minute I 
48 Sec. 



NO 
NO 
NO 

NO 

NO 

NO 

NO 

$49.95 




NOW YOU CAM SAVE ANY SCREEN, PROM ANY PROGRAM, ANYTIME WITH GRABBIT. 



With GRABBIT you can capture 
exactly what you see on your screen 
in an Instant, regardless of what 
programs you're running. GRABBIT 
works with all video modes, 
including "Hold and Modify." 
What's more, GRABBIT runs 
completely in the background, 
transparent to your other software. 
GRABBIT Is always ready for you to 
use, even when you're In the middle 
of another program. As if that is not 
enough, GRABBIT requires only 
about 10K RAM to operate, and it 
supports dozens of printers, 
GRABBIT is truly a productivity 
power tool for your AMIGA! 



GRABBIT is far superior to other 
screen-printing "programs" because 
of its small size and quick 
performance. No complicated setup is 
required, Just Install and go! Also, 
GRABBIT doesn't require the screen 
to remain visible during printing or 
saving, and stopping the print 
operation is as easy as starting it. 
GRABBIT supports all standard 
Amiga printer drivers. GRABBIT also 
supports full color printing. 

In addition to GRABBIT's printing 
capabilities, the package also 
includes a powerful utility program 
"ANYTIME." The ANYTIME bonus 



program Is a "Preferences" style 
palette requester that allows you to 
change any colors of any screen, 
anytime! With ANYTIME, you are 
NOW capable of customizing all 
colors to match your printer's 
hardcopy to the screen's colors. 

Once you start using GRABBIT and 
the bonus program ANYTIME you 
will want it on every disk. You get 
all the power of this sizzling new 
software for an unbelievably low 
SZ9.9S + S5 shipping and handling. 



With Key Genie — One Key Launches 1000 Strokes! 



This amazing keyboard macro 
processor is just what you need 
to give your fingers a rest. The 
Genie is always at work to save 
you time and keystrokes. 
Complicated or repitlous 
keyboard sequences are easily 
assigned to a key you choose 
through the Genie's Pop- Up 
Macro Definition Window. You 
can also load and save your 



favorite macro sequences on disk. 
Once saved, the macros can be 
automatically installed at startup 
to save time. In addition to the 
Genie's powers, Discovery 
Software has added a bonus 
program "Turbo- Shell". The Shell 
is an AmigaDOS performance 
enhancer that you shouldn't be 
without! The Shell gives you the 
capability to recall previous CLI 



commands with the arrow keys 
so that mistyped commands can 
be quickly corrected, and 
frequently used commands can 
be easily repeated. Fast 
AmigaDOS command replacements 
give you UNIX-style performance 
from your Amiga, 
What other software does so much 
for you at such a low price. Only 
S 49,9s + 85 shipping and handling 




When ordering from overseas, 

add an additional $5.00 shipping for 

first class airmail. 

11-1-86 



'SolmVARE 9 03 E.WiUow Grove Ave., Wyndmoor, PA 19118 (215) 242-4666 

| IN 1 I H\.\ HON At 

AmlgaTM is a registered trademark of Commodore- Amiga Inc. UNIX la a registered trademark of Bell Laboratories 



make the system "build" the RAM disk. 

Assuming you have already used IconEd 
to create your own personal disk icons, you 
mav be disappointed to see that the RAM 
disk icon is the old default disk icon. To 
change this, use the following command in 
place of the do-nothing Dir command sug- 
gested above: 

COPY DISK.INFO TO RAM: 

This command copies your system disk's 
icon image into the file Ram:Disk.info, 
where it will be used to draw the RAM 
disk's icon. You could instead create a cus- 
tomized icon just for the RAM disk and 
keep that icon in a separate file on the sys- 
tem disk. If your RAM disk icon were 
called, say. Ramdisk.info, you would use this 
startup-sequence command: 

COPY RAMDISK.INFO TO R\M:DISK.INFO 

Some notes: First. Intuition apparently ig- 
nores the extra disk-type info file on the 
system disk. Next, since the RAM disk icon 
is created only once each session, there is 
no need to leave the Disk.Info file in the 
RAM disk after it's been used. Third, a 
Snapshot of the RAM disk will not be per- 
manent unless you copy RAM's Disk.Info 
file back to its file on the system disk. Of 
course, files in the RAM disk will be lost 
when you reboot or turn off your Amiga. 

Let me mention once again that this 
trick will only work on version 1.2 system 
software. 

Marcus Brooks 
Austin, TX 

Hidden Debug Menu 

For a bit of fun, type this command from 
a CLI window: LOADWB - DEBUG. Now 
go to the Workbench and select the Special 
menu. While still holding the mouse button, 
slide the pointer to the right and voila! A 
hidden menu. The items in this menu cause 
debugging information to be sent out the 
serial port at 9600 baud. Anyone with an 
RS-232 terminal lying around can lap into 
this feature. 

Bryce Nesbitt 
Berkeley, CA 



Words And Pictures 

Notepad Address Book 

The Notepad consists of 10 pages, each 
with 49 rows of text. If each page is titled 



with 3 consecutive letters of the alphabet, 
the remaining 48 rows can be used as an 
address book and/or phone directory. I've 
found it easiest to keep the screen default 
width and use the sizing gadget to drag the 
window to full length before saving. There 
is even room for an opening title page. If 
you put V, W, X, Y and Z at the top of the 
last page, you have enough room for a page 
of notes or important dales on the last 
page. Using the Style menu allows for end- 
less creativity, and the address/phone list- 
ings can easily be printed. 

Paul Elliot 
Suffietd, CT 

Getting Behind Textcraft 

Some software, like Textcraft, has no doc- 
umentation for how to change screens with 
the Amiga-N and the Amiga-M keystrokes. 
For instance, in Textcraft. most people are 
probably selecting the Quit option from the 
menu whenever they want to see the Work- 
bench screen (e.g., to move an icon for an- 
other project into the same drawer as the 
Textcraft project). But there is a much 
faster way to return to Workbench without 
breaking out of Textcraft: Just open the 
Workbench Clock before opening Textcraft. 
Then, from within Textcraft, Amiga-N will 
switch you to the Workbench screen and 
Amiga-M will return you to Textcraft. 

Andrew Lichtman 
Nellie Gail Ranch, CA 

CLI Typewriter 

If you want to use the Amiga and your 
printer as a typewriter, all you have to do is 
enter COPY * TO PRT: from the CLI 
prompt. From then on, everything you type 
on the keyboard will be printed on the 
printer. To cancel the command, press 
CTRL and \ at the same time. We've used 
this technique to make labels for slide trays, 
8mm movies, video cassettes and even a list 
of Amiga commands for quick reference. 

Ms. V. Bende 

Whitby, Ontario 

Canada 

Ed Prompts 

If you're like me and you use ED a lot, 
you also keep forgetting what keys do what. 
I end up overusing the "easy-to-remember" 
keys and wasting a lot of time thumbing 
through (he manual. Here is a better way. 
Using ED (what else?), make a cheat sheet 
with all the info you think you'll need. 
Make sure that it doesn't fill up more than 
one screen and then save it as FdHelp, or 



something you'll remember. Before using 
Ed for another project, just enter TYPE ED- 
HELP. You'll see your screenful of informa- 
tion appear. Next, use ED as usual, and 
anytime you need some help, simply click 
the window depth arrangement gadget in 
the upper right-hand corner of the screen; 
your list will appear. Click the window 
gadget again to return to your ED project. 
The only drawbacks to this technique are 
that you have to do it for each ED session 
and the help screen can only take one 
screen or the info at the top scrolls off. 

James Nakakihara 
Utsunomiya, Japan 

Double-Spaced Printout Fix 

Here are a few hints for those of you hav- 
ing printer problems. If you have a printer 
(like many Radio Shack printers) that re- 
quires a CR (carriage return) without the LF 
(line feed) or it will double space every- 
thing, there is a simple way to fix your 
printouts. First, create a simple two-byte file 
named HLF (or something appropriate) 
composed of the control sequence that your 
printer needs to get a half forward linefeed. 
(On my Tandy printer this sequence is 
S1B,S1C.) Then, in the first line of your 
startup-sequence file add the line TYPE > 
PAR: HLF or, if you are using the serial 
port, TYPE SER: HLF. 

Now whenever you boot up your system 
you can output text via the PRT: and have 
everything come out single spaced, assum- 
ing that you are using the Generic printer 
driver or a driver that works with your 
printer. If you wish, you can also include- 
any escape sequences in your HLF file to 
do things like condensed or bold printing. 

Scott Cabit 
Columbia, CT 

Printing With ED 

Before buying a word processor I used 
the Amiga editor, ED. I gather that many 
people use ED for letters, short articles, etc., 
so this tip might be of help to them. 

1 found thai using the formula described 
in your magazine for controlling the 
printer paper feeds, formatting and page 
breaks wasn't the answer I needed, so I 
came up with a one-line alternative. After 
the text has been drafted, use this ESC com- 
mand: 

T; SL10; SR70; BS; M30; BE; WB/PRT: 

In this example you can change the values 
for left margin (10), right margin (70) and 
last line to be printed (30) to fit your print- | 



12 Special Issue 1987 



XEROX 




I 



*■■■! 


■■>■ 


■■ 


■n 


mi 


■■■■ 


■■ 


'"•9 


Ami 


■■■■ 


■I 


i i 


1 Ml 




n 


! \ 


1 !■-■■ 


i-i 


if 


pffi 


* h i" ?■ p p 




C^i^TTSntxyg rjrtfrtvi 









REVENUE OOMMmSOMa 




OnAPMCSAPPt CATIONS 



&UK.« 







m 


Xf BOX 4020 
Cote* tafc M Mam 


□ '.'•*• «*n «*d colon 

■ Thoywxhd tutor 

n ggbj taodohpw 

■ 40 1 M cfH l*il mode 

1 1 \ >tv ir«xtr*it li*tfs 







The Xerox 4020 Ink- Jet Printer is 
headlines with unlimited color. 




If you want to make headlines with 
your next business presentation, try 
adding color with the Xerox 4020 

Color 
Ink-Jet 
Printer. 
The 
4020 is a 
high- 
quality, 

attractively priced printer that mixes 
text with brilliant color graphics. It 
employs the latest advances in ink-jet 
technology to deliver seven distinct 
colors which combine to produce over 
4,000 different shades. 
But the 4020 makes more than just a 






colorful impact It also has a resolution 
that few color ink-jet printers can 
match, prints 2 to 3 times faster than 
comparably priced color printers, and 
can be installed by just about anyone in 
less than 10 minutes. 

Like all Xerox products, the reliable 
4020 is backed by one of the best 
service and support organizations in 
the industry: Team Xerox. To learn 
more about the 4020 Color Ink-Jet 
Printer, send in the i 



! I'd like to learn more about the 4020 Color 
Ink- Jet Printer and what it can do for my 
business presentations. 

□ Please send me more information. 

□ Please have a sates representative contact me. 

Send this coupon to: Xerox Corporation, 
RO. Box 24, Rochester, NY 14692. 



Team Xerox 



coupon below or 
call 1-800-TEAM- 
XRX,exLl99A. 

We've got a colorful solution to your 
business needs. 



Or, if you can 1 ! wail, call 

1-800-TEAM-XRX, ex*. 199A. 

mA^ (1-800-832-6979, ext. 199A-) mo-wtj 

XEROX* .™ J0;o arc irajsmats of XESOX CORPORATION 



er's needs and page length. To print subse- 
quent pages, replace the T with M values, 
For example: 

M31; SL10; SR70; BS; M60; BE; WB/PRT: 

Lee Akazaki 
Toronto, Canada 

DeluxePaint Keyboard Colors 

I use DeluxePaint frequently, and over the 
months I have stumbled upon a couple of 
undocumented keyboard color commands. 

The 7 and 8 keys {on either the main key- 
board or the keypad) subtract and add to 
the level of red in the currently selected 
foreground color. The 4 and 5 keys work 
the same way for green. The 1 and 2 keys 
work for blue. These are the keyboard 
equivalents of the RGB sliders on the 
graphic palette. Note that these keys are not 
subject to the limitations of the graphic pal- 
ette involving colors 1 and 2. (See the man- 
ual for details.) 

Pressing the Help key will set color 1 to 
black and color 2 to white. These colors are 
used by DPaint to draw the menus, and 
loading a picture made with another pro- 
gram may make their values too close, ren- 
dering the icons and title bar invisible. 

Finally, the braces { and } (shifted 
bracket keys) allow you to step through the 
palette to select the background color in 
the same way the bracket keys [ and ] (un- 
shifted) allow you to select the foreground 
color. 

Bryan Costin 

Woodbine, MD 



Disk Management 

Copy of Another Type 

Another way to copy a file is by using the 
Type command under the CLI. 

The Type command will display the con- 
tents of a file in either ASCII or hex, de- 
pending upon the option used and, of 
course, the file being accessed. 

Normally, the return is to the screen or 
prt:. However, 1 have discovered that it can 
also be to a disk or file, and if a file is not 
specified, one is created. 

The format is as follows: 

TYPE DF?: file name TO file name 

For example, let's say you have a file on a 
disk in drive 1 called Amiga World and you 
want a copy on the disk in drive to be 
called Mags. In the CLI, you would type the 



following command string: 

TYPE DFLAMIGAWORLD DF0:MAGS 

Note that the use of TO is optional. 
When you now do a directory search, you 
should find a new file called MAGS 
on DF1:. 

David Morgan 
Robina, Queensland, Australia 

Transferring Preferences 

Some Amiga software will not load if 
your Workbench disk has been loaded be- 
fore it; therefore, the most obvious way of 
using the same Preferences settings as on 
your Workbench disk is to open the Prefer- 
ences on the new disk and reset everything. 
However, there is an easier way. Although it 
doesn't say so anywhere in the manual, 
everything saved in Preferences resides in 
the system-configuration file. To easily 
transfer all your settings to a different disk, 
just enter the following line from the CLI: 

COPY WORKBENCH:DEVS/SYSTEM- 
CONFIGURATION TO YourNewDisk 

VolumeName-.D'EVSISYSTEM- 
CONFIGURATION 

Don't forget to make a backup of any disk 
that you are writing to before using this 
technique. 

Mark Cashman 

Windsor, CT 

Three Copy Tips 

1) Copying files can be a very slow process, 
especially if the source and destination files 
are on the same disk. This is because 
AmigaDOS uses a maximum buffer size of 
512 bytes. 512 bytes are read, then written, 
read then written, etc., until die file is cop- 
ied. You can increase the buffer size, and 
on files of 10K or so you can also increase 
the copy time by a factor of five or more. 
From the CLI use this sequence: 

COPY sourcefilename TO RAM: 
COPY RAM\sourcefilename TO 

desthm tionfilename 
DELETE RAM'SOurcefilenatne 

2) If you find yourself copying a large num- 
ber of files between multiple disks, no 
doubt you're sick of reinserting your Work- 
bench disk every time you turn around. 
The reason you have to keep swapping 
disks is that AmigaDOS has to reload the 
copy program each time it is used. You can 
eliminate all the swapping by putting a 
copy of COPY on a RAM disk by entering 



the following sequence from CLI: 

COPY C:COPY TO RAM: 

Then when you want to copy a file type: 

RAM:COPY sourcefilename TO 
destinationfilename 

3) The last copy trick is to use RENAME in- 
stead of COPY. This will only work if the 
source and destination files are on the same 
disk and if you only want one copy of the 
file, not two. For example, you could use 
RENAME to move a file from one subdirec- 
tory to another subdirectory on the same 
disk. The advantage to using RENAME over 
COPY is that the file is not copied— only its 
pathname is changed. The RENAME com- 
mand lakes less than a second, regardless of 
the size of the file. 

David Allen 
Westbury, NY 

More Space on Disks 

One way to make more space on disks is 
to delete the files that are not needed in 
the SYS:DEVS/PRINTERS directory. If you 
use one of the printer drivers provided by 
Preferences, you simply delete the others. 
Let's say you want to keep the Generic 
printer driver and delete the rest. Just enter 
the following from the CLI prompt: 

CD DEVS 

COPY PRINTERS/GENERIC TO SYS:T 

CD : 

DELETE SYS:DEVS/PRINTERS ALL 

CD DEVS 

MAKEDIR PRINTERS 

COPY SYS:T/GENERIC TO PRINTERS 

CD : 

It is a good idea to do a DIR DEVS/PRINT- 
ERS before deleting printer files just to see 
how they list your printer (type it exactly as 
they do) and, as always, don'! do this on your 
original Workbench disk! What if you buy a 
new printer someday? 

Eric Schmid 
Varberg, Sweden 

Quicker Disk 

With a two-drive system, you can improve 
your directory access times on frequently 
used disks using a simple trick. Just format 
a new disk (and INSTALL if it is going to 
be a Workbench disk), then with the disk 
you want "fixed" in the internal drive and 
the new disk in the external drive, from the 

Continued on p. 96 
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Software designed for AMIGA. 



Lattice® C Compiler 



New version 3.1 of the AMIGA DOS C Compiler replaces version 
3.03. Major enhancements include the addition of: TMU, an 
assembler, a faster linker and version 3 MS-DOS. 

With more than 30,000 users worldwide. Lattice C Compilers 
set the industry standard for MS-DOS software development. 
Lattice C gives you all you need for development of programs 
on the AMIGA. Lattice C is a full implementation of Kernighan 
and Ritchie with the ANSI C extensions and many additional 
features. 

Professional La nice* C Compiler S3 75. 00 

A new product called the Professional Lattice C Compiler is now 
available It includes the C Compiler package (complete with TMU), 
plus LMK. LSE and the Metascope Debugger. 

AMIGA C Cross Compiler S500. 00 

Allows AMIGA development on your MS-DOS system. Price includes 
the Professional Lattice C Compiler described above. 

Lattice Screen Editor (LSE"'') $100. 00 

Designed as a programmer's editor, Lattice Screen Editor (LSE) 
is fast, flexible and easy to learn. LSE's multi-window environ- 
ment provides all the editor functions you need including block 
moves, pattern searches and "cut and paste." In addition, LSE 
offers special features for programmers such as an error track- 
ing mode and three Assembly Language input modes. You can 
also create macros or customize keystrokes, menus, and prompts 
to your style and preferences. 

Lattice dBC III 7 '' Library $150. 00 

The dBC 111 library lets you create, access and update files that 
are compatible with Ashtoii-Taie's dBASE system. dBC Ill's C 
functions let you extend existing dBASE applications or allow 
your users to process their data using dBC III or dBASE III. 

Lattice Text Utilities (TMU™) $15. 00 

Lattice Text Utilities consists of eight software tools to help vou 
manage your text files. GREP searches files for the specified 
pattern. DIFF compares two files and lists their differences. 
EXTRACT creates a list of file names to be extracted from the cur- 
rent directory. BUILD creates batch files from a previously gen- 
erated file name list. \VC displays the number of characters and 
optionally the checksum of a specified file, ED is a line editor which 
can utilize output from other TMU software in an automated batch 
mode. SPLAT searches files for a specified character string and 
replaces every occurrence with a specified string. And FILES lists, 
copies, erases or removes files or entire directory structures which 
meet the specified conditions. 



$225.00 Lattice Unicalc* Spreadsheet 



$7995 



(nicalc is a simple-to-operale program that turns vour AMIGA 
computer into an electronic spreadsheet. Using Unicalc vou can 
easily create sales reports, expense accounts, balance sheets, 
or any other reports you had to do manually. 
Cnicalc offers the versatility you've come to expect from busi- 
ness software, plus the speed and processing power of 
the AMIGA. 

• 8192 row by 256 column processing area • Comprehensive context- 
sensitive help screens • Cells can contain numeric, algebraic formulas 
and titles • Foreign language customization for all prompts and 
messages • Complete library of algebraic and conditional functions 

• Dual window capabilities • Floating point and scientific notation 
available • Complete load, save and print capabilities • Unique 
customization capability for your every application • Full compatibility 
with other leading spreadsheets • Full menu and mouse support. 

Lattice MacLibrary" $100.00 

The Lattice MacLibrary" is a collection of more than sixty C 
functions which allow you to quickly and efficiently take 
advantage of the powerful capabilities of the AMIGA. 
Even if your knowledge of the AMIGA is limited. MacLibrary 
can ease your job of implementing screens, windows and 
gadgets by utilizing the functions, examples and sample pro- 
grams included with the package. 

Other MacLibrary routines are functionally compatible with the 
most widely used Apple* Macintosh'" Quickdraw Routines'", 
Standard File Package and Toolbox Utility Routines enabling 
vou to rapidly convert vour Macintosh programs to run on 
the AMIGA. 

Panel" $195.00 

Panel will help you write your screen programs and layer your 
screen designs with up to ten overiappi ng images. Panel's screen 
layouts can be assigned to individual windows and may be 
dynamically loaded from files or compiled into a program. Panel 
will output C source for including in your applications. A mon- 
itor and keyboard utility is also included to allow you to cus- 
tomize your applications for other systems. 

Willi Lattice products you get lattice Service including telephone sup- 
port, notice of new products and enhancements and a 30-day money- 
hack guarantee. Corporate license agreements available. 



Lattice 



Lattice, Incorporated 
Post Office Box 3072 
Glen Ellyn, Illinois 60138 
(312)858-7950 TWX 910-291-2190 

INTERNATIONAI SALESOmCE& Benelux: InesDatacom (32)2-720-51-61 
Japan: Lifeboat, Inc. (03J293-4711 England; Roundhill (0672)54675 
France: SFL (1)46-65-11-55 Germany: Pfotenhaur (49)7841/5058 

Hong Kong: Prima K52sKh42'j2 i ; A.I. Soft Korea, Inc. (02)7836^72 
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Beginner's Guide 
To the CLI 

There's more to life than icons, and the 

Command Line Interface isn't as frightening as it sounds. 



N 



By Peggy Herrington 

ow that you own the world's most powerful personal 
computer, isn't it about time you learned how to use it? 
If you're just running programs the easy way from 
Workbench, you're not getting the most from your sys- 
tem. In fact, you're missing out on all sorts of power 
that you paid for. 

The CLI — the Command Line Interface (or Inter- 
preter, if you prefer) — is your means of communicating 
directly with AmigaDOS, the Disk Operating System. 
While using the CLI is trickier than clicking on icons, it 
taps into the power behind Workbench, and there are 
many things you simply can't do any other way. But 
rather than listening to reasons, try a taste of the CLI 
and decide how palatable it is. 

Escape Hatch 

Don't worry, nothing you can type from the CLI will 
damage your system. The worst you can do is inadvert- 
ently alter a disk, and since you always keep a backup 
copy, you can start over should something go wrong. 
You could conceivably meet up with a "guru" or lockup 
the system, but, if all else fails, you can always do a 
warm boot: simultaneously press the Control Key 
(CTRL) and the two red Amiga keys on either side of 
the space bar. Use the warm boot sparingly — only when 
(here is no other recourse — because a warm boot clears 
random memory, destroying your hard work in RAM. 

Play It Again, Sam 

Before using the CLI, you have to activate it. To begin, 
click on the Preferences Icon in Workbench, and, after 
the Preferences screen appears, click the CLI ON 
square. You might want to change the screen output to 
80 columns while you're at it. Save the Preferences 
changes by clicking the Save indicator. Perform a warm 
boot to engage the 80-column mode, then click on the 
Workbench System Drawer to get the CLI Icon, Click 
on it and voila! You're looking at your first CLI win- 
dow. Move the box to the top of the screen with the 
drag bar and, using the gadget in the lower right cor- 
ner, resize it to fill the entire screen. 

Now comes the good part. You'll use the CLI to copy 



your Workbench disk and to personalize your startup 
sequence. 

When you use Diskcopy from Workbench, you must 
swap disks whether you have one or two disk drives, 
but by using Diskcopy from the CLI, you can copy disks 
on a two-drive system without any swapping. As a pre- 
caution, make sure the write-protect notch on your 
Workbench disk is up in the inhibit position, so that 
you can't write to it accidentally. If you have two drives, 
put a new, unformatted disk in DFL, the external drive, 
and from the CLI type (it doesn't matter a whit whether 
you use upper or lower case): 

CD DF0:SYSTEM 
DISKCOPY DFO: TO DF1: 

This tells the Amiga to copy everything from the disk 
in the internal drive onto the disk in the external drive. 
Simply type DISKCOPY DFO: if you have a single 
drive — the difference is that you'll have to swap disks 
instead of watching the system read from one and write 
to the other. When you're finished, put the original 
disk away and warm boot with the new Workbench disk 
in DFO:. You'll notice that this method of copying gives 
the copy the same name as the original disk rather than 
calling it Copy of Disk name, as the Workbench-based 
copy does. Check it out by typing INFO. 

3%" Filing Cabinets 

Think of your disks as little filing cabinets. Information 
is stored in files, which are in turn categorized in draw- 
ers or directories, just as in standard office filing cabi- 
nets. Directories can be nested, one inside another, but 
to access inner directories, you must work through the 
outer ones first. Tn the CLI, a directory is created with 
the command MAKEDIR DFn: directory tuime (n 
being drive through 3, or DHO: for a hard drive). 
Since a disk must be mounted before the system will 
recognize it, this duality — the ability to access a disk by 
its volume name or its device name — comes in handy 
when you change disks. 

You can get the system to recognize the presence of a I 
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If a command 
doesn't work as you 
think it should, try 
typing WHY. 
Although it may be 
cryptic, you'll get 
some kind of an 
explanation. 



newly inserted disk or switch back and forth between 
directories with the CLI command CD, which stands for 
Current Directory. CD DFO: will take you to the inter- 
nal drive, CD DF1: to the external drive, or CD disk 
name: to a specific disk, if you know its name. Like 
file names, directory names with spaces must be en- 
closed in double quotation marks. For example, CD 
Joes Disk: won't work; CD "Joes Disk:" will. 

Now type CD DFO:. On the next line, type DIR. The 
names of all the DIRectories on that disk, followed by 
programs not inside a directory, will be printed to the 
screen. DIR OPT A lists all of the directories on the 
current disk followed by the names of the files inside of 
each. It's helpful for locating a file on a disk when 
you've forgotten which directory it's in. With any of 
these commands, screen output can be paused by press- 
ing the space bar and resumed by pressing back space, 
or permanently halted with CRTL-C. 

Notice the directory named System on the Work- 
bench disk. You can see what's inside it by typing 

CD SYSTEM 
LIST 

The LIST command shows the size of each file in num- 
ber of bytes, its protection (if any) and the date and 
time it was saved. The Files with .info extenders contain 
information for Workbench icons that correspond to 
programs of like names, Diskcopy and Diskcopy.info, 
for example. Don't confuse .info extenders with the 
command INFO that lets you sec how full a disk is by 
blocks (512 bytes each). When you're finished looking 
around the System directory, type CD / to back up one 
directory and, in this case, get back to the root direc- 
tory of the Workbench disk. An interesting place to try 
navigating nested directories is the DEVS directory on 
this disk. If you get lost, type CD and the system will 
tell you where you are. CD DFO: will take you back to 
the top. 

File Folders 

Disks hold two kinds of Files, those containing readable 
text or ASCII, and those with binary data, which are 
usually programs. If you're still in the System directory 
on the Workbench disk, type TYPE DISKCOPY OPT H 
and you'll see the binary listing of the program Disk- 
copy. When you've had your fill, hit CRTL-C to stop. If 
you tell the system to TYPE that file (or any binary file) 
without specifying Option H, you'll get flashes and sym- 
bols; CTRL-C works here as well. The COPY command 
moves files between disks, including the RAM: disk, and 
directories. Try COPY DF0:SYSTEM/DISKCOPY TO 
RAM:. Then go to RAM: and see if it's there 

CD RAM 
DIR 

Most public domain and many commercial disks con- 
tain text files called something like README, which 
have information or instructions that aren't in the 
printed documentation. They frequently don't have 



icons, and without the CLI, you might not even know 
they're there. Text files can be read from the CLI by 
simply typing them to the screen: TYPE README, for 
example, although the name must be entered precisely 
as it appears on the disk, enclosing it in double quota- 
tion marks if it contains a space. Try it yourself by 
reading the Startup-sequence text file in the s directory 
of your Workbench disk: 

CD DF0:S 

TYPE STARTUP-SEQUENCE 

Text files can be sent to a printer with TYPV, filename 
TO PRT:. You can also turn the CLI and your printer 
into a typewriter by typing COPY * TO PRT:. Every- 
thing you type after will he printed on paper when you 
hit return. Hold down CTRL and \ (backslash) to get 
the CLI back. Incidentally, if a command doesn't work 
as you think it should, try typing WHY. Although it 
may be cryptic, you'll get some kind of an explanation. 
And if you can't remember the proper syntax, type the 
command followed by a space and a question mark. 
You then get the syntax of the command, although the 
results are normally very cryptic. 

Say Hi to ED 

Many programs used by the CLI are in the C (Com- 
mand) directory. The system seeks them via a standard 
PATH (which you can change) and you call them by 
typing their names. Try typing 

CD DF0:C 
LIST 

Or, if you're the orderly type, DIR will display them 
alphabetically. 

One of the handiest of these programs is the text edi- 
tor, ED. While not a full-fledged word processor, ED is 
convenient for making batch or EXECUTE files, like 
Startup-sequence in the S directory, which is executed 
at start-up. This file contains CLI commands that are 
executed whenever you boot up your system. You can 
edit this file to ask you for the current date and time 
and automatically move some oft-used commands into 
the internal RAM: disk where they will operate faster 
and free-up your disk drives for more important 
chores. To call ED and load the file, tvpe: 

CD DFO: 

ED S/STARTUP-SEQUENCE 

ED will present the disk file onscreen. To move about, 

use the arrow keys or the following combinations: 

ESCape-B moves to the bottom of the file. 
ESC-T moves to the top of (he file. 
ESC-Q quits without saving any of your changes. 
ESC-X exits and rewrites the file, saving your changes. 
CTRL-B deletes the line the cursor is on. 
CRTL-A adds a blank tine below the line the cursor 
is on. ►■ 
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Que Pencil . . . 




Ttuckinbug: Derek Grime/Beyond Graphics 



EASYL 



Woif And Femme 2 : Nick Poliwko/Pixelight 

(fjvj) 



Pressure Sensitive Drawing Pad 

What It Is . . . I Who Uses It 

EASYL is a pressure-sensitive tablet j Artists, animators, teachers, design- 

which allows you to draw directly into j j ers and students around the world 

the computer with an ordinary pencil i have found EASYL to be the ideal 

and paper. | drawing tool for the Amiga. 



How It Works . . . 

Draw or trace directly into Deluxe - 
Paint II, Pagesetter or any other 1.2 
mouse-based software. Click to load 
the driver, keystroke to remove it. 
The Source Code is available. 

ANAKIN RESEARCH, INC. 

100 Westmore Drive, Unit 11C 

Rexdale, Ontario, Canada 

M9V 5C3 

(416) 744-4246 




Why Buy It . . . 

Because your time is valuable, and 
you want to express your creative 
ideas quickly and naturally. 

Where To Buy It . . . 

Contact your local Amiga dealer. 

Coming Soon! 

Cel animation/pencil test 

software and storyboard 

software. 



EASYL is distributed in North America and Europe by 



Canadian Distributor 

Air-Stat of Canada, Markham, Ont. — (416) 477-9440, (416) 493-8854 

U.S. Distributors 

American Software Distributors Inc, Urbana, 111. — 1-800-225-7941, 

in Illinois (217) 643-2050 
CSS East, Cambridge Mass. — 1-800-343-7535, 

in Mass. (617) 876-2505 
CSS, Chicago, 111. — 1-800-422-4912, in Illinois 1-800-331-SOFT 
Southern Technologies Inc., Dallas, Texas — (214) 247-7373 



European Distributors 

Easy Computing, Brussels, Belgium — 02 660 6390 

Ingeniorfirmaet E J., Bagsvaerd, Denmark — 02 44 0488 

Precision Software Limited, Worcester Park, England — 01 330 7166 

Computer Concept, Paris, France — 47 07 5715 

Quest, Verona, Italy — 45 585 302 

Data Technology Management (DTM), Wiesbaden, West Germany — 

06121 407989 
Microtron Computer Produkte, Pieterlen, Switzerland — 03 287 2429 



Amiga ia a regiatered trademark of Commodore-Amiga. Ensyl ia ■ registered trademark of Arnkin Research, Int.. DclmoPaint ia a registered trademark of Electronic Arts, PageSetter is a registered trademark of the Cold Disk. 
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When you fed comfortable with the controls, edit the 
file to read: 

Echo Workbench Release 1.2 Version 34.37 

Echo "Note: This System insured by Smith & Wesson" 

Echo "" " 

Echo "Last Date: " 

Date 

Echo " " 

Date ? 

Date to DFO:S/LAST-STARTUP-DATE 

Echo " " 

Echo "Putting SYStem into RAM:Drive. Hold on a 

minute. . ." 

Echo " " 

Echo "If you don't want me to, press CTRLD now!" 

Watt 5 

Makedir RAM:t: 

Copy SYS:C TO RAM:C ALL QUIET 

Assign C: RAM:C 

Echo " " 

Echo 'Tress CTRLD to abort Loading Workbench" 

Wait 5 

Loadwb 

Echo " " 

Echo "Let's compute!" 

Echo " " 

When you're done, quit ED with ESC-X, which will au- 
tomatically save your new file to disk. 
Do another warm boot to test vour handiwork. The 



Software: 



CLI-Mate 

Progressive feripherals and Software 
464 Kalamath Street 
Denver, CO 80201 

The Metacomco Shell 

Metacomco 

5353E Scotts Valley Drive 

Scotts Valley, CA 95066 



ZING! 

Meridian Software Inc. 
PO Box 890408 
Houston, TX 77289-0408 



Books: 

The AmigaDOS Manual, 2nd Ed. 
Commodore-Amiga/Bantam Books 
666 Fifth Avenue 
New York, NY 10113 

AmigaDOS Reference Guide 
Compute! Books 

324 West Wendover Ave., Suite 200 
Greensboro, NC 27403 



Mastering AmigaDOS 
Arrays, Inc. 

6711 Valjean Avenue 
Van Nuys, CA 91406 



system should prompt you for the time and date in the 
format HH:MM DDMMM YY, recording it in a file 
called LAST-START L'P -DATE. Unless you press CTRL- 
D. the machine will then copy everything from the C 
directory to RAM: and load Workbench, leaving you an 
active CLI with Workbench behind it. With this setup, 
you don't need the Workbench disk in the drive to use 
most C commands. If you did press CTRLD and want 
Workbench, simply type LOADWB. You can customize 
this file by putting fewer of the C commands into 
RAM:, where they take up memory and limit your ca- 
pacity for running large programs. Delete them by first 
typing 

ASSIGN C: "WORKBENCH 1.2:C" 
CD RAM:C 
DELETE #? 



Walking and Chewing Gum 

Everyone knows you run a program from the Work- 
bench by clicking on its icon. From the CLI. you run it 
by simply typing its location or the path followed by its 
name, DFI: SCRIBBLE! for instance. If you take the sys- 
tem down the path first by typing DF0: or DFI: and 
preface the name by typing RUN SCRIBBLE!, you can 
then multitask. Memory permitting, you can run con- 
currently as many programs, officially called tasks, as 
you want, setting the priority for each with SETTASK- 
PRI (- 5 to + 5). If you have expansion RAM, vou can 
dump a file to your printer with TYPE, create NEW- 
CLIs and SORT another file alphabetically or numeri- 
cally, use DISKDOCTOR to fix a damaged disk, RUN a 
background music program and chat online all at the 
same time. 

Still not convinced that using the CLI pays off in the 
long run? Then consider that many public-domain pro- 
grams don't come with icon files, which means they 
aren't accessible from Workbench, You'll need to be 
fluent in CLI to download and organize them on disks 
in directories. The FILENOTE command in particular 
is handy with these files. With it, you can append an 
80-character message to a file that will appear when you 
LIST it. Type FILENOTE program name (the note 
itself, enclosed in quotes if you use spaces). 

A host of other commands are accessible from the 
CLI. They're listed in the Reference Guide bound into 
this issue. The best way to master them is simply to get 
in there and experiment. If you get confused, there are 
a couple of programs on the market that tame the CLI, 
notably CLI-Mate from Progressive Peripherals, ZING! 
from Meridian Software and Metacomco Shell from 
Metacomco. For old fashioned instruction, books on 
AmigaDOS (listed below) are available, as well. One last 
tip, if your confidence needs a boost, try typing: 
PROMPT "%N> Yes, oh Master? ". You'll be pleased 
with the results. ■ 

foggy Herrington is a Contributing Editor to AmigaWorld. 
Write to her c/o AmigaWorld editorial, 80 Elm Street, Peterbor- 
ough, NH 03458. 
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Now Look At Word Processing 
In A Whole New Light. 
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ProWritel All Others Pale By Comparison. 



You chose Amiga*' because you wanted some- 
thing more. Now you choose your software for 
the same reason. Which makes choosing Pro- 
Write word processing a very bright idea. 

The Full Spectrum of Capabilities. 

ProWrite lets you select more than just a 
typeface: You get proportionally spaced charac- 
ter fonts. Brilliant color. Unsurpassed graphics 
capabilities. And no surprises. Because what 
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you see on the screen with ProWrite is a letter- 
perfect picture of what you'll see printed on the 
page — from header to footer, right down to 
the last pixel. 

Creative Control: A Bril 
liant Stroke. With six pull- 
down menus, Just a click of the 
mouse or a few keystrokes is all 
you need to create, delete, copy, 
alter, move and otherwise ma- 
nipulate text. Multiple selections create a limitless 
choice of character fonts, colors, sizes and styles. 
Customize everything from a daily diary to an 
annual report, including color graphics. And 
with headers and footers alwa\s clearly displayed, 
ProWrite makes even advanced formatting as 
easy as dragging a mouse. 

Ease of Use: Another Bright Idea. 

ProWrite delivers more of what you bought Amiga 
for Professional output. Multi-tasking power. 



vm 




A "creative edge." 
You gui open up 
to eight windows 
at once — and 
perform a variety 
of editing tasks be- 
tween them. With 
ProWrite, you'll al- 
ways know exactly what you're 
doing, because you see it 
done — in living color — right 
before your eyes. 

See for yourself what you get with ProWrite. 
Then, just for fun, take a look at the others — 
and watch them pale by comparison. 



New Horizons 



j 



First In Personal Productivity And Creativity. 



New Horizons Software, Inc. PO Box 43167, Austin, TX 78745 (5121 329-6215 
ProWrite is a trademark of New Horizons Software. Inc. Amiga is a registered I rademark of Commodore-Amiga, Inc. 
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Reviews of Aztec C68k/am v 3.2 were great. 

Aztec CtiHkgaes into overdrive for benchmark speed . . . 

Byte November, 1986 

Aztec C is more than just a C compiler . . . compiles programs significantly 
faster than Lattice . . . options that for many applications, will improve program 
execution performance dramatically . . . code generated by Aztec Curas 
dramatically smaller than that produced by Lattice. 

Amiga World November, 1986 

Now, the New Aztec C68k version 3.4 is even 

faster, more flexible, and dramatically less expensive. 

We did it! We moved all of the great development utilities from Aztec 
C68k/am-c, our $499 system, to Aztec C68k/am-d, our S299 system. 
We packaged the same compiler, assembler, linker, libraries, and 
librarian that are in the S499 system into Aztec C68k/am-p, The 
Professional System, and priced it at $199. Is that all we did? Not by a 
long shot! 

We also added new features, speeded up the already impressive per- 
formance, and we listened. We listened to what users were saying on 
the technical support lines, on the East Coast Bulletin Board, the West 
Coast Bulletin Board, and on BIX. Then we responded by correcting, 
adding and augmenting to satisfy every one of the major requests. The 
result is three carefully packaged and reasonably priced high perform- 
ance development systems that will do everything you could possibly 
want with the Commodore Amiga. 

To back up this claim, we offer a 30-day money back satisfaction 
guarantee. The system must be purchased by an end user directly 
from Manx to qualify for the 30-day return, but that's it. Less than one 
per cent of the systems we sell to end users are ever returned, and over 
60% of the systems we sell are repeat sales or by recommendation of an 
existing user. That says a lot. 
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Manx Software Systems 
One Industrial Way 
Eatontown, NJ 07724 



Manx has a reputation as the expensive system to use for high de- 
mand professional applications, but the new prices and reconfigurations 
make our high powered systems attractive to everyone. In addition, 
Manx has aggressive site licensing, multiple purchase discounts. OEM. 
educational, and other special purpose discounts. Call us today for 
more details. Join the over 50.000 satisfied end users who understand 
the Manx difference. 

New Features: shorter development times • smaller faster code 'support 
for 1.1 and 1.2 Amiga DOS 'direct link of Amiga object modules and 
libraries "standard driver support • C and assembler support for 68020 and 
68881 'scatter loading and support of overlays by segmentation »1.2 
Amiga library function support 'debug utilities 'enumerated data types 
• stack depth checking code 'Amiga assembly directives support 'four 
floating point formats: Motorola fast float, Amiga IEEE double, Manx IEEE 
double, 68881 'dynamic memory allocation and window sizing for the Z 
editor • "touch" command • improved console window RAW and CON 
switching »sfdio I/O is buffered to console '68010, 68020 debug 
support • "exec" function supports Amiga PATH command •VTT00 emulator 
(source) 'lots of examples 

New Configurations and Pricing 

Aztec C68k/am-p (The Professional) $199 

Optimized C, Assembler. Linker, Librarian. Libraries, Examples 

Aztec C68k/am-d (The Developer) $299 

Optimized C, Assembler, Linker, Librarian, Libraries, Debugger, 
Make, Diff, Crep, Support Utilities, Examples 

Aztec C68k/am-c (The Commercial System) $499 

Library Source, One Year Of Updates, Z (vi) editor, Optimized C, 
Assembler. Linker, Librarian. Libraries. Debugger, Make, Diff. 
Crep. Support Utilities, Examples 

All systems are upgradable by paying the difference in price • S10. C.O.D., VISA, 
MasterCard. American Kxprcss, wire (domestic or international), and terms are available. 
One and Two Day deliver} 1 available for all domestic and most international destinations. 



To order, or, for information call today. 

1-800-221-0440 



Telex: 4995812 
In NJ or outside the USA call (201) 542-2121. 

Amiga is a registered TM of Commodore Inl'l , Lattice TM Lattice. Inc. 
Circle 319 on Reader Service card 



IFF: The Standard 
Of Sharing 

Though IFF is a buzzword in the Amiga community, for many its meaning 
remains a mystery. Here's an explanation of what it is and what it's used for. 



By Louis R. Wallace 
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he Interchange File Format (IFF) is a standard method 
of recording data objects so they can be shared by 
many different programs. The IFF standard was 
adopted by Commodore-Amiga soon after the Amiga's 
release and has become so widely accepted in the 
Amiga community that any program that does not sup- 
port it will instantly find itself subjected to an ava- 
lanche of criticism. The data can be graphics, text, 
fonts, music, sound effects, musical instruments or ani- 
mation. It was developed by Electronic Arts in 1985 to 
simplify the software development process. While 
designed with the Amiga in mind, it is not system spe- 
cific and can be used by other computer systems. In 
fact, there is growing support for IFF standards to be 
incorporated into the Atari ST programming 
community. 

By using software that has the IFF format, you have 
the ability to move data created with one application 
into another independently-developed application. The 

ILLUSTRATED BY LYNN BUSHMAN 



beauty of this is most readily apparent to users of the 
Amiga's many graphic programs. For example, Deluxe- 
Paint will easily load and edit a picture created with 
Aegis Images or Graphicraft. These same images can 
then be used in DeluxeVideo or Aegis Animator, or 
transferred to DeluxePrinl. With the inexpensive Digi- 
View graphics digitizer from NewTek, you can take 
color photographs and save them in IFF format, load 
them in DeluxePaint for editing and then use then as 
background scenes for the Animator. 

In designing the IFF standard, Electronic Arts consid- 
ered the history of data standards and types for \arious 
microcomputers. One of the systems often cited ras the 
Macintosh, whose Resource Manager and Scrap Man- 
ager allow data objects to be swapped between applica- 
tions. Four-digit identifiers within the file structure ►• 
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represent the different data types in the file. The Mac- 
intosh PICT graphics format stores graphics commands 
and their drawing sequences, which later can be easily 
accessed and used. 

Used by the Apple LaserWriter to describe an image 
for high-quality printed output, PostScript was exam- 
ined as a general way to represent a print image. Other 
file formats studied were the DIF format for spread- 
sheet data interchange, and InterScript from Xerox, 
used to transfer text information between different text 
editors with varying degrees of formatting features 
support. 

By proposing a standard format structure. Electronic 
Arts wanted to avoid a situation where hordes of pro- 
grammers would wantonly create whatever file formats 
were most expedient for their specific applications. 
They felt "a little behind-the-scenes conversion when 
programs read and write files is far better than explicit 
conversion utilities for highly specialized formats." 
IFF provides the backstage magic. 

Since Amiga data can be quite complex with bitmaps, 
flags, instruments and such, it is organized into chunks. 
All IFF files contain header information that describes 
the data's various parts. The data can be interpreted as 
eight-bit integers, signed or unsigned 16-bit integers 
and 32-bit integers, depending upon what is required. 
The data chunks are identified by four ASCII charac- 
ters in the range of S20-S7E. Every IFF file will contain 
one or more of these four-digit type ID codes. To access 
any specific chunk of data, the file-reader program 
examines and discards chunks it has no need of, until it 
finds the proper one. Since each chunk is identified 
with its four-digit type ID, it is easy to add new types 
without interfering with compatibility by simply assign- 
ing the new data chunk a unique type ID. 

A chunk, the basic building block of IFF files, con- 
tains the chunk name or type ID, the size of the data 
chunk in bytes, and the data itself. In C the structure is 
defined as: 

typedef struct { 
LONG chunkID; 



Figure 1. Hex and ASCII dump of an Interleaved Bitmap file. 



FORM 

0000: 

0010: 

0020: 

0030: 

0040: 

0050: 

0060: 

0070: 

0080: 

0090: 

OOA0: 

00B0: 

00C0: 

O0DO: 

OOEo: 

00F0 



ILBM 

464F524D 
00000014 
O000OA0B 
101010F0 
A090A090 
90D0A080 
D09080BO 
80 50 A0 70 
20202020 
43524E47 
43524E47 
43524E47 
43524E47 
424F4459 
08FE8009 
20CBF7CF 



00009100 
014000C8 
014000C8 
E0C0F0D0 
80807060 
C09070B0 
7070EOBO 
40705030 
7090C060 
00000008 
00000008 
00000008 
00000008 
00009030 
0000FE00 
C3FF2CFF 



494C424D 
00000000 
434D4150 
BOCOB0A0 
F0D0B0F0 
8060A070 
80D0A070 
50403040 
70904050 
00000000 
00OO0AAA 
00000AAA 
00000AAA 
240007 FE 
11FFC003 
FFEC0380 



424D4844 
05020100 
00000060 
DOB090BO 
C0A0E0B0 
50906040 
C09060BO 
30203020 
60203030 
0001 141F 
00010307 
00010000 
00010000 
70F04000 
40718D06 
41CCFE00 



FORM ILBMBMHD 
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p..*p.@P' 00 

CRNG 

CRNG.. 

CRNG 

CRNG 

BODY... OS... p. @. 

@q.. 

, A... 



LONG chunksize; 
UBYTE chunkdatafchunksize]; 
} Chunk; 



If chunksize is an odd number, the chunk will contain a 
zero pad byte at the end of the chunk data. This byte is 
not included in the chunksize. The chunk header and 
the chunksize bytes are not counted either, so the total 
physical size of a chunk is chunksize + 8 ( + 1 if 
chunksize is an uneven number of bytes). 

All IFF files begin with a special ID type called 
FORM, LIST or CAT. The CAT type is a concatenation 
of objects, while LIST is a list of FORMs and CATs. In 
FORM, the most common type, the four letters (FORM) 
are found at the beginning of the datafile and imply 
that the chunk contains an ID, and possibly contains 
other nested chunks of data. So the letters FORM arc 
the chunk ID, and are followed by a 32-bit integer con- 
taining the chunksize. This is the size of the entire 
datafile chunk itself, including other chunks of data 
that can be found within its structure. Electronic Arts 
suggests the first chunksize be used to determine the 
virtual EOF (End Of File). Next we find another 32-bit 
integer called a FormType, which defines the type of 
data structure you will be working with. If the formtype 
is ILBM (InterLeaved BitMap image with color map), 
the graphic bitmap image will be defined in the follow- 
ing data. If it is SMUS you have a Simple MUsic Score, 
while FTXT stands for Formatted TeXT, 

All of the IFF files examined here are of the FORM 
type. By understanding what the file structure is you 
will be able to use these files within your own pro- 
grams, or write IFK-coinpatible files from your 
programs. 

Bitmap Graphics 

An ILBM file has one of three main functions. It can be 
a standalone image that specifies exactly how to dis- 
play itself, in terms of resolution, size and colors. It can 
be an image meant to be merged into a larger picture 
that has its own number of bitplanes and color palette. 
Or finally, it can be an empty image file that contains 
color palette information. Exactly which version it is 
depends on what it's to be used for. 

Figure 1 is the beginning of the contents of an IFF 
graphics image file. By using the CLI command TYPE 
FILENAME OPT H, you can display both a hexidecimal 
data dump and an ASCII listing of any file. The various 
type IDs are visible in the ASCII portion, while the data 
itself is available in the hex dump. 

As you can see, the first four bytes identify this as an 
IFF file of type FORM. There are four bytes identifying 
the chunksize (S9100 bytes) of the entire file. This is 
followed by the type ID ILBM, signifying it is a raster- 
graphics image. The fourth set of four bytes is BMHD 
(BitMapHeaDer). A PROPERTY type ID, it is a special 
chunk containing the description of the image, neces- 
sary to decode the BODY to come. Following this 
BMHD chunk ID is the required chunksize information 
for this PROPERTY chunk, in this case $14 (decimal 20)1 
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Actual un re touched photos 



DICI 



VIEW 



brings the world into your Amiga! 




w: 



r ith Digi-View and a video camera, 
V V your Amiga can see! Faces, logos, 
artwork . . . anything you can imagine! 
Simply point your camera and click the 
mouse. In seconds, whatever the camera sees 
is painlessly transformed into a computer 
image that can be printed, stored on disk, or 
transferred to other programs, imagine how quickly and easily you 
can generate stunning video art and animation when you start with 
high quality digitized photographs or artwork. 



Sophisticated software included with Digi-View makes it easy 
to produce dazzling, broadcast-quality color images. Intuitive, 
on-screen controls are as easy to use as the knobs on your T.V. set 
Digi-View can capture images 
in several modes, including 
320x200 pixels with up to 
4096 colors on screen ("hold- 
and-modify" mode), and the 
incredibly detailed 640x400 
high resolution mode. 




The key to Digi- 
View's incredible 

color resolution is 
this color separa- 
tion filter which 
attaches to yow 
black-and-white 
or color video 
camera. ' 



• IFF disk format works with Digi-Paint™, DeluxePainf' M . DeluxeVideo 

• Saves time! No more hours of freehand drawing and redrawing. 

• Send photos over the telephone with your modem and terminal software 

• Capture images for scientific image processing or pattern recognition. 

• Spice up business graphics — slide show program included. 

• Incorporate photos in posters and greeting cards. 

• Use Digi-View pictures in your BASIC programs. 

• Catalog images with IFF database programs. 

• Make red/blue 3D photos. 

• A powerful tool for commercial graphic artists 



, DeluxePrint, Aegis Images'^'. Aegis Animator, and more! 



Panasonic WV-1410 video camera iv/lens 
CS-1 L, Copy stand weights 




On.y$ 199.95 

includes viduo digitizer module, 
color separation filler, software and manual. 



Orders Only 1-800-843-8934 
Customer Service (913) 354-9332 

NewIek 

INCORPORATED 

701 Jackson • Suite B3 • Topeka. KS • 66603 

Amiga is a trademark of Commodore-Amiga. Inc. Kgi-Vicvj and Uigi-ft.nl are trademarks of NeWftk. Inc. DeluxePaint. DeluxeVideo. and Oclu.^l'rhrt are trademarks of Electronic Arts. Inc. Aegis Images and Aegis Animator are 
trademarks of Aegis Development, Inc. 

■ Digi-View software wison 2.0 (or newer! required to use color camera. For maximum resolution use monochrome camera with 2.1 interlace. High-res color modes require 1 Meg expansion RAM. 
? 1986 Ne*Tek. Inc. 
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You will see a 
one-to-one corre- 
spondence between 
the C structure 
above and the 20 
bytes of data. 



bytes. The next 20 bytes arc the most descriptive parts 
of the ILBM, and are best understood in the context of 
a C chunk structure. 

typedef struct { 
LONG chunkID; 
LONG chunksize; 
UWORD width.height; 
WORD xposition,yposition; 
UBYTE numberofplanes; 
UBYTE mask; 
UBYTE compression; 
UBYTE padbyte; 
UWORD transparentcolor; 
UBYTE xAspect, yAspect; 
WORD pageWidth, pageHeight; 
} BitMapHeader; 

If you look at the data in Figure 1 following the 
BMHD chunksize word (SI 4), you will see a one-to-one 
correspondence between the C structure above and the 
20 bytes of data. The structure shows that two 16-bit 
unsigned words of two bytes each contain the values 
for the width and height of the image. In this case these 
are S0140 (320 decimal) and S00C8 (200 decimal). The 
next two words are the x and y position of the image 
on the screen. Here they are both zero, but if this had 
been a BOB or sprite, a different position might have 
been required. 

The next byte in the structure is the number of bit- 
planes deep the image is. It can be from one to five (six 
in Hold-and-Modify mode) planes deep. The sample 
image is five bitplanes. Byte 10 is the MASK flag, indi- 
cating which type of four possible masking types is 
being used. The first possibility is inskNone with a 
value of zero, meaning there is no mask and the image 
is an opaque rectangle. A value of one indicates msk- 
HasMask, signifying there is an interleaved mask plane 
in the BODY bitplane data. A value of two is mskHas- 
TransparentColor, indicating some portions of the 
image are transparent. The value of three, mskLasso, 
means the file reader can construct a lasso mask in the 
manner of MacPaint. The example in Figure 1 has the 
value two, so the image has the MASK 
mskHasTransparentColor. 

Byte 1 1 in the BMHD PROPERTY chunk is the 
compression flag. The value zero means no compres- 
sion. The example has the value one, signifying the bit- 
map data has been compressed. A value of one further 
indicates it is the standard compression type used by 
Electronic Arts for raster graphics. If the compression 
flag is greater than one, it signals a different compres- 
sion routine, which must be known to any reader pro- 
gram in order to decode the data. Electronic Arts has 
released into the public domain standard C procedures, 
called Packer and Unpacker, to compress and uncom- 
press ILBM data. (For an Amiga Basic IFF ILBM 
decompression routine, called BRUSHF.STOBOBS, see 
AmigaWorld Jan/Feb 1987.) Byte 12 is a pad byte of zero 
and is not used at the moment in the BMHD data, but 
could be used in the future. 



The next two bytes are the transparentC.olor value, 
which specifies which bit pattern is to be transparent, 
and are relevent only if the mask flag is mskHas- 
TransparentColor or mskLasso. For the example, the 
value is zero. 

Bytes 15 and 16 are the xAspect and yAspect ratios. 
In most cases these will be 10:11 ($0A:$0B). Finally, the 
words pageWidth and pageHeight are the size in pixels 
of the source page, in this case 320 x 200 ($140, $C8). 

The next type ID, CMAP (Color MAP), is a PROP- 
ERTY chunk structure that contains the information for 
the color registers. Its C structure is: 

typedef struct { 
LONG chunkID; 
LONG chunksize; 
UBYTE chunkdata[ chunksize]; 

} colonnap; 

The chunkID is CMAP, the chunksize is 
3 x 2 A numberofplanes (96 decimal in this case), and the 
chunkdata is the RGB data values for each color, 
expressed as triplets. The triplet (0,0,0) is black, while 
(255,255,255) is while. Only the high-order bits are used 
on the Amiga, so each shade is limited to 16 incre- 
ments (16 x 16 x 16 = 4,096). 

CRXG (Color Register RaNGe) is an ID type used by 
DeluxePaint from Electronic Arts to identify a continu- 
ous range of color registers for a shade range or color 
cycling. Its chunk structure is very simple. 

typedef struct { 
LONG chunkID; 
LONG chunksize; 
WORD padl; 
WORD rate; 
WORD active; 
UBYTE low, high; 
} CRangc; 

Here padl is two unused bytes, set to zero. Rate is 
the color-cycle rate, active indicates whether color 
cycling is on (one) or off (zero). Low and high bytes are 
the color registers used in this color range. 

The BODY' type ID is a standard chunk structure 
consisting of a chunkid, chunksize and chunkdata, fol- 
lowed by a pad byte if needed. It represents the actual 
bitmap image. 

The Amiga's raster images are interleaved in the ILBM 
file. Figure 1 describes a five-bitplane image, so the 
data consists of one scan line from each bitplane 
before going to the next scan line. The length of the 
scan line must always end on a word (two-byte) bound- 
ary; if not, it is padded with zero bits until it does. This 
data may then be compressed as in the example. 

Oiher PROPERTY chunk types can be in an Il.BM 
Form. There is a GRAB chunk, which has two words 
identifying the position of a handle, or hotspot, within 
an image. The DEST chunk tells how to scatter bit- 
planes into a deeper destination image. SPRT indicates 
that the image is a sprite. CAMC is a proprietary ► 
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The 4096 Colpr A Paint Program 
for the Amiga" 





Create original art with a palette of 4096 colors. 



Load H.A.M. images from Digi- View™ or 32 color images from 
Deluxe Paint™ and other IFF programs. 



From the creators of Digi-View comes Digi-Paint, the first paint program to take 
full advantage of the Amiga's exclusive "hold-and-modify" mode. No longer are 
you limited to 32 colors. With Digi-Paint, you can use all 4096 colors on screen 
simultaneously. Features include brushes, smooth shading, magnify, cut & paste, 
output to printer, and full IFF load and save. Digi-Paint was programmed 
completely in assembly language for the fastest possible response. Give your 
Amiga the graphics power of systems costing thousands of dollars more. See your 
Amiga dealer today or call toll-free for Digi-Paint, the 4096 color paint program. 



Only 



$59.95 



Orders Only 1-800-843-8934 
Customer Service (913) 354-9332 

NewIek 

INCORPORATED 

701 Jackson • Suite B3 • Topeka, KS • 66603 



Amiga is a trademark of Commodore-Amiga. Inc. Dirti-faint and Digi-View are trademarks of NewTek, Inc. DeWPaint is a trademark nl" Electronic Arts. Inc. 

i 1936 NewTek. Inc. 
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Amiga chunk, for Amiga-only display modes like Hold- 
and-Modify or Dual Playfield. 

Sound 

The IFF sound file 8SVX FORM is the defined File for- 
mal for digitally sampled sound consisting of eight-bit 
samples. It can be a single (oncshot) octave sound or 
several octaves. Figure 2 shows a portion of the data 
obtained from a oneshot IFF sample made with the 
FutureSound sound digitizer from Applied Visions. 

It begins with the chunkID FORM, followed by the 
chunksize $0BF8. The next four bytes spell 8SVX, indi- 
cating an eight-bit digitally sampled sound file. This is 
immediately followed by the ID VHDR (Voice HeaDeR) 
chunk structure. 

typedef struct { 
LONG chunkID; 
LONG chunksize; 
ULONG oneShotHiSamples, 

repeatHiSamples, 

satnplesPerHiCycle; 
UWORD samplesPerSec; 
UBYTE ctOctave, 

sCompression; 
LONG volume; 

}Voice8Header, 

The fields oneShotHiSamples and repeatHiSamples 
contain the number of audio samples in the two parts 
of the highest frequency octave. One can be empty 
(zero), and in the example oneShotHiSamples contains 
the amount SBDO, and the repeatHiSamples is zero. 
The samplesPerHiCycle field contains the number of 
samples per cycle in the highest frequency, or a zero if 
that is unknown, as in Figure 2. 

The samplesPerSec field contains the sound sampling 
rate; here it is $2710. Next is ctOctave, the number of 
octaves in the BODY chunk structure. Since the exam- 
ple is a oneshot octave, it contains the number one. 
The sCompression field indicates whether the BODY 
data is compressed or not, and if so what kind of 
compression has been applied. A zero indicates no 
compression, as in the example. A one in this field 
indicates the standard compression method for sam- 



Figure 2. Hex and ASCII dump of an eight-bit sampled sound file. 



FORM 
0000 
0010 
0020 
0030 
0040 
0050 
0060 
0070 
0080 
0090 
O0A0 
O0B0 



8SvX 

464F524D 

00000014 

27100100 

00000000 

00000101 

; 01010102 

: 01010101 

; 00000000 

: 0QO0FFFF 

: FFFEFEFF 

; 02020202 

: 04040404 



0OOO0BF8 
00000BD0 
00010000 
00000000 
01010101 
01010101 
nioiolO! 
00000000 
FFFFFFFF 
FF000101 
02030303 
03030303 



38535658 
00000000 
424F4459 
00010000 
01010101 
01 rim ni 
01000100 
00010101 
FEFD1-DFD 
01010201 
03030303 
03030303 



56484452 
00000000 
OOOOOBDO 
00000000 
02010101 
02010101 
01000000 

oioioioo 

FDFDFDFD 
02020202 
04040404 
03020202 



FORM 8SVXVHDK 

.BODY 



pled sound, Fibonacci-Delta encoding, was used. Any 
other value signifies a different compression technique. 
However, the Fibonacci-Delta compression technique is 
not recommended for sampled sound as it may intro- 
duce distortion. The last parameter in the VHDR chunk 
structure is the volume field, a :52-bit integer value. 
Though not used in [his particular case, there are 
other chunks that can be included within the 8SVX 
FORM. Text chunks are used to include specific infor- 
mation, such as NAME, (c) (copyright), AUTH (author) 
and ANNO (annotations) chunk tvpes. Their chunk 
structures are all similar, 

typedef struct { 
LONG chunkID; 
IjONG chunksize; 
CHAR text[ chunksize]; 

} textchunk; 

Optional data chunks include ATAK and RLSE, for 
use in describing an Altack/Sustain/Release envelope. 

The BODY data chunk consists of the chunkID, 
chunksize and the chunkdata. The chunkdata is in 
signed bytes (-128 through 127 instead of zero to 255), 
unless it has been compressed. If compressed, the data 
is simply unsigned bytes of information, until 
decompression when it becomes signed again. 

Another sound FORMTYPE is SMUS (Simple MUsi- 
cal Score). This is a data format for moving classical 
(not free-form) musical scores between programs. SMUS 
uses Common Music Notation {half notes, dotted 
quarter rests, etc.), and can define which instruments 
play which notes. It consists of various data-chunk struc- 
tures, as well as text structures. For example, it begins 
wilh the required property SHDR. 

typedef struct { 
LONG chunkID; 
LONG chunksize; 
UWORD tempo; 
UBYTE volume; 
UBYTE ctTrack; 
} SScoreHeader; 

Tempo is expressed in 128th's of a quarter note per 
minute. Volume is from 0-127, and ctTrack is the num- 
ber of TRAK (Track) data chunks, up to 255. 

The optional property INS1 identifies the instru- 
ments used in the score. As with many of the IFF 
chunks, they can be accepted or ignored by your IFF 
reader program. 

typedef struct { 
LONG chunkID, 
LONG chunksize; 
UBYTE register; 
UBYTE type; 
UBYTE datal, data2; 
CHAR name[J; 
} Reflnstrument; 

The register field, from zero to 255, is used to incli- ► 
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the new 

MaxiPl 

Plus... 




4«h = 552,122 



it's making every other 
spreadsheet old fashioned! 



The original MaxiPlan™ was named 
the Best Amiga™ Spreadsheet of 
1 986 by F.A.U.G.. the world's 
argest and most active Amiga 
jser group. Now in 1987, Oxxi is 
aroud to introduce MaxiPlan 
Plus 1 *— the most advanced Amiga 
ipreadsheet ever. With even more 
ime-saving innovations than the 
iward-winning MaxiPlan, the new 
MaxiPlan Plus includes Microsoft 
Excel ""-like Macros and Utilities. 

Vith MaxiPlan Plus and your 
kmiga you can: 

Open multiple spreadsheets 
md graphs 

"Link" data from any number of 
preadsheets 

Create a self-running demo or 
nteractive multiple choice quiz, 
tcorporating files from word 
processors and paint programs 

Automatically create reports 
uch as invoices and purchase 
rders 



Instruct a data entry person with With the MaxiPlan Plus Data 



speech or written prompts 

• "Recite" your data entries when 
checking data accuracy against 
source documents 

• Export graphs via an IFF file to 
any Amiga paint program 

The MaxiPlan Plus Spre. ' 
features: 

• SI 2 columns by 65,530 rows 

• Function key commands 

• Ranges or cells referenced by 
"Name" or cell numbers 

• Written or spoken notes that 
attach to cells or ranges 

• Password protected cells 

• Easy-to-use pie, bar, line and 
area graphs 

• Up to 8 graphs per spreadsheet 

• Lotus 1-2-3 compatibility 

• 63 built-in functions such as: 

— Financial IIRR, PV. NPV. FV, PMTI 

— Data base (Index. Find, Lookup) 

— Presentation IColor, Style. Speech I 



Base you can: 

* Sort on any number of fields in 
any order 

* Maintain up to 16 data bases 
per spreadsheet 

. Create merge files for labels or 
form letters 

"Find" or "Lookup" any specific 
record or records 

With the MaxiPlan Plus Macros 
you can: 

* Define up to 32 macros for any 
spreadsheet 

* Activate macros with a single 
key stroke 

* Automatically generate macros 
under record mode 

* Use over 70 different macro 
commands 

. Create templates for data entry 

* Incorporate speech to instruct, 
remind or inform user 



MaxiPlan Plus"* 

$199."" 

at your local Amiga software 

dealer. 



flXX/i™, 

1 835 A Dawns Way 

Fullerton, CA 92631 
1714)999-6710 



in. nifilMtrl" 



MaxiPlan 
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of 1986 for its outstanding mouse 
interfaces, unique pull-down menu 
and advanced speech capabilities. 
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You can 

understand and use 
files written by 
other programmers 
for your own 
purposes. 



cate the instrument to play. If (he type field is zero, 
then it finds the instrument by the supplied name and 
sets datal and data2 to zero. If type is one, it uses the 
instrument on MIDI channel number data], preset 
number data2. The NAME[] field holds the instrument 
name. 

IRAK chunks contain the main part of the score. 
These represent parallel tracks, with one chunk per 
track. As mentioned, you can have up to 255 TRAKs in 
a SMUS FORM, but the numerical order of the various 
TRAKs is also their priority number. So if a reader pro- 
gram is designed to read four TRAKs, it should read 
the first four and ignore the rest (if any). 

The TRAK chunks contain the data in 16-bit words 
or events that represent commands. These commands 
can be simple events like "note" or "rest," or more 
complex like "set instrument." Events are called SEvent 
records (Simple musical Event), and the 16 bits in each 
field are broken into two 8-bit parts. The first part is 
the sID, which determines how the data is interpreted, 
and the second is the data itself. There are a number of 
predefined sID values, indicating chords, notes, rests 
and instruments. 

Text 

The IFF FORM for text files is called FIXT (Formatted 
TeXT), and is meant to serve as a means of communica- 
tion between text applications. These applications can 
be as simple as printable alphanumeric characters with 
spaces and linefeeds, or as complex as documents with 
embedded format information such as fonts, text size 
or typeface. As with any IFF reader program, FTXT 
programs can use what they need or understand, while 
ignoring the rest. 

FTXT uses the eight-bit character streams defined in 
the ISO/ANSI standard (International Organization for 
Standardization (ISO) and American National Stan- 
dards Institute (ANSI)). The data is stored in two con- 
ventional data chunks, CHRS and FONS. 

The FTXT formtype may contain many CHRS 
(CHaRacter Streams) chunks. Their format in C is: 

typedef struct { 
LONG chunkID; 
LONG chunksize; 
CHAR text[chunksize]; 
} characterstream; 

The FONS type is a property type that contains infor- 
mation about assigning a particular font to a font regis- 
ter, which can be referenced within CHRS chunks. 
Obviously, it also should contain information on the 
font type. 

tvpedef struct { 
' LONG chunkID; 
LONG chunksize; 
UBYTE fontID; 
UBYTE pad 1 byte; 
UBYTE proportionaLflag; 
UBYTE serif_flag; 



CHAR fontnamef); 

} FontSpecifier; 

The fontID field contains a number from zero to 
nine. The padlbyte is an unused field, and should be 
zero. The proportional—flag specifies if the font is pro- 
portional or not. The serif_flag indicates if it is a serif 
or a sans serif font. In both cases, one stands for no, 
two for yes and zero for an unknown status. 

IFF Programming 

For Amiga programmers, it is welcome news that these 
highly defined file formats exist. They more than make 
up for their occasional extra programming burden in 
the ease with which you can understand and use files 
written by other programmers for your own purposes. 
It is even better to find that Electronic Aris and Com- 
modore have made available to the public domain a 
large number of C and Amiga Basic programs and C 
include files that represent and demonstrate the IFF 
standard. 

For S20, the "EA IFF 85" STANDARD FOR INTER- 
CHANGE FORMAT FILES is available from Commo- 
dore, An extensive and invaluable manual on the 
various IFF formats, it provides a disk complete with all 
the C source routines, include, object, link and text 
files. There is also the C source to the SEEILBM pro- 
gram, written by Carolyn Schcppncr of Commodore's 
Technical Support Staff. The C source routines include 
the Packer and Unpacker data compression procedures, 
as well as file read and write routines. 

If you are interested in programming IFF examples 
from Amiga Basic, the new Version 1.2 Enhancement 
release contains several useful and educational pro- 
grams that are also written by Carolyn Scheppner. 
Besides programs to load, save and print ILBM files 
from Amiga Basic, there is a routine for converting an 
ILBM file to the ACBM (Amiga Contiguous BitMap) 
picture formal. While this is not a standard interleaved 
bitmap file, it does decrease significantly the already 
fast load time for displaying a picture from Basic. 

One of the best utilities to play digitized sounds from 
Amiga Basic is available from Applied Visions Inc. 
They have some very interesting examples of playing 
digitized sounds from Amiga Basic using a special set 
of library commands supplied with the FulureSound 
digitizer.! 

The Electronic Arts IFF 85 Manual ($20) 

Amiga Technical Support 

Kim Montgomery 

1200 Wilson Drive 

West Chester, PA 19380 

(Make the check out to Commodore Business Machines 

and request the IFF docs and disk.) 

FutureSound and Amiga Basic digital 

sound routines ($175) 
Applied Visions Inc. 
One Kendall Square, Suite 2200 
Cambridge, MA 02139 
617/494-5417 
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The Masquerade Is Over 



ONLINE! The Original 
Telecommunications Standard 




Online! — a legend in its own time. All of us know 

that. Now we present Online! 2.0 to you... 

The Re-birth of a standard. 



Online! 2.0 is not a mere face lift. We spent 

long Research and Development hours 

segregating YOUR letters and not only 

added valuable suggestions, but threw 

in a few trade secrets of our own. 



So, if things like 9600 Baud without delay, 

KERMIT protocol, auto-chop and clip 

board support appeal to you, feel free to call 

us, or your local dealer with more inquiries. 

If the above specifications don't do a thing for 

you, perhaps an Online! telephone book to make 

calling multiple bulletin boards easier, a Review 

Buffer to re-read text that scrolled too fast at a 

later time and 132 column support will! 

Now, take a second to think about 

who's masquerading, but only a second, 

and then concentrate on the REAL Online! 



Call us now, repeat the phrase 
"THE MASQUERADE IS OVER" 
and receive a FREE T-SHIRT 
with your order or upgrade. 

(OFFER GOOD WHILE SUPPLIES LAST!) 




7 Years of Quality Software and Still Growing Strong! 



SUGGESTED RETAIL $69-95 

FOR DEALER NEAREST YOU: (800) 327-8724 



MICRO-SYSTEMS 

IE, INC. 
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The Amiga Connection 



AMIGA COMPUTERS 
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New Amiga systems are being introduced. 
Call for pricing on Amiga 500 and Amiga 
200 system packages. 

Genlock Interface 249.00 

256K RAM expansion 149.00 



ACCESSORIES 



DATA SHIELD 

300 Watt Backup 379.00 

500 Watt Backup 589.00 

Turbo 350 Watt Backup 449.00 

P150 Power Director w/Modem 119.00 

S85 Surge Protector 69.99 

FIFTH GENERATION 

Logical Connection 256K 299.00 

KALAMAR DESIGNS 

3V2 M Disk Cabinet - Teak 14.99 

5Vi" Disk Cabinet - Teak 19.99 

KENSINGTON MICROWARE 

Master Piece 99.99 

Printer stand 19.99 



MONITORS 



AMDEK 

Color 600 Hi-Res (640x240) 399.00 

MAGNAVOX 

515 RGB/Composite 299.00 

643 14" RGB 419.00 

NEC 

JC 1401 Multisync/RGB In Stock 

ZENITH 

ZVM 1220/1230 (ea.) S99.99 

ZVM 1330 16 color RGB 459.00 

AMIGA 

1080 Hi-Res Color 269.00 



MODEMS 



ANCHOR 

Volksmodem 300/1200 139.00 

Signalman Express 1200 EXT 199.00 

Lightning 2400 Baud EXT 319.00 

HAYES 

Smartmodem 300 139.00 

Smartmodem 1200 389.00 

Smartmodem 2400 599.00 

COMMODORE 

Amiga 1680-1200 BPS 179.00 

PRACTICAL PERIPHERALS 

1200 BPS External 159.00 



PRINTERS 




JUKI 55 IOC PRINTER *379°° 

EPSON 

LX-86 120 cps 239.00 

FX-85, FX-286 Call 

EX-800, EX-1000 Call 

LQ-800, LQ-1000, LQ-2500 Call 

HI80 4 Pen Plotter 359.00 

Free book w/purchase 
HEWLETT PACKARD 

Think Jet 399.00 

JUKI 

5510C Color Dot Matrix Call 

6000 12 cps Daisywheel Call 

6100 18 cps Daisywheel Call 

6200 30 cps Wide Carriage Call 

6300 40 cps Wide Carriage Call 

NEC 

CP660 Color Printer 589.00 

OKIDATA 

Okimate 20 Color Printer 129.00 

ML-182 120 cps Dot Matrix 219.00 

ML-192 160 cps Dot Matrix 339.00 

ML-193 + , ML-292 + , ML-293 + Call 

STAR MICRONICS 

NL-10 Font Compatible Call 

NX-10 120 cps Dot Matrix 219.00 

TOSHIBA 

P321 24 Wire 80 column 479.00 

P341 24 Wire 136 column 589.00 

P351 24 Wire 136 column 1049.00 



DISK DRIVES 



COMMODORE 

Amiga 1010 ZW 219.00 

Amiga 1020 5V<" 189.00 

MICROBOTICS 

20 mb Hard Drive 1299.00 



DISKETTES 



MAXELL 

3V2" DS/DD (10) 21.49 

5V4" DS/DD (10) 10.99 

SONY 

3V2" DS/DD (5 w/case) 9.99 

3Vz" DS/DD (10) 20.49 

5V4" DS/DD (10) 9.99 

FLIP N FILE 

25 Disk Tub 3Vfe" 9-99 

GENERIC 

3Vz" DS/DD (10) 19-99 

3Vz" DS/DD Bulk 50 Pack 89.99 



SOFTWARE 




Micro Systems 

ORGANIZE 



*64 



99 



ACTIVISION 

Borrowed Time 32.99 

Hacker 32.99 

Mind Shadow 32.99 

AEGIS DEVELOPMENT 

Animation/Images 79.00 

BATTERIES INCLUDED 

Isgur Portfolio System 169.00 

COMMODORE 

Textcraft w/Graphic Craft 59.99 

Musicraft 79.99 

TLC Logo 79.99 

Amiga Pascal. 79.99 

Lattice "C" 119.00 

Assembler 79.99 

Lisp 156.00 

Enhancer DOS 1.2 14.99 

DISCOVERY SOFTWARE 

Marauder Back-up 32.99 

ELECTRONIC ARTS 

Deluxe Paint 69.99 

Archon 31.99 

One on One 31.99 

Sky Fox 31-99 

Financial Cookbook 37.99 

Seven Cities of Gold 31.99 

Arctic Fox 31.99 

Deluxe Print 74.99 

Instant Music 34.99 

Deluxe Video 69.99 

INFOCOM 

Wishbringer 31.99 

Hitchhiker's Guide 31.99 

Spellbreaker 31.99 

Planettall 31.99 

Witness 31.99 

MEGASOFT LTD 

A-Copier 34.99 

A-Report 44.99 

MICRO ILLUSIONS 

Dynamic-Cad 349.00 

MINDSCAPE 

Halley Project 31.99 

Deja Vu 34.99 

Keyboard Cadet 29.99 

MICRO SYSTEMS 

Analyze Version 2.0 119.00 

Scribble 64.99 

On-Line/Comm 49.99 

SUBLOGIC 

Flight Simulator II 37.99 

V.I.P. 

V.I. P. Professional 139.00 




In the U.S.A. and Canada 



COMPUTER MAIL ORDER 



Call toll-free: 1 800 233-8950 

Outside the U.S.A. 717 327-9575 Telex 5106017898 

Corporate and Educational Institutions call toll-free: 1 800 221-4283 

C.M.O. 477 East Third Street Dept. B905, Wllllamsport, PA 17701 

All major credit cards accepted 

POLICY: Add 3%. minimum S7.00 shipping and handling. Larger shipments may require additional 
charges Personal & company checks require 3 weeks clearance. For faster delivery use your credit 
card or send cashiers check or bank money order. PA residents add 5% sales tax. Defective soft- 
ware will be replaced with same item only. All items subject to availability and price change. All 
sales final, returned shipments are subject to restocking fee. 



Circle 316 on Reader Service card. 



vennve/\pproacJ 
To Practical 
Reality 



you just have to take 
matters ^f into your own hands. Or 
hand, ^r Mote than once, a brainstorm 
has turned into a shower of practical 

reality. To the skeptic, the truth can be 
shocking^ 

Well, now you can start your AMIGA 
flying high with the dynamic, new ZING! 
utility programs from MERIDIAN SOFT- 
WARE, INC. 

ZING! programs are the hesr program 
companions for the AMIGA on the mar- 
ket today. Separately, they are practical, 
yet dynamic working partners. Strung to- 
gether. . .the sky's the limit! 

The High Point In Software Innovations . . . 

"MERIDIAN 
SOFTWARE 
INC. 

890408 Hous 
(713)48 





The fatten and easiest vwry to work 
with the AMIGA. ZING] is actually a 
collection of utility programs which, after 
installation, ate invisible until called up 
by the user thtoufjh the use of hot keys. 
The main goal erf ZINGf. is to essentially 
eliminate the need to le.un the operating 
*ysiem protocol and cryptic (.ommandv. 

Fiinctinm include: copying editing* 
deleting, Mining, renaming, >earching, re- 
cirganiung files, and much mure! Ship- 
ping now for: S79.95 





ZlNOlKeys £■ a sophisticated, 
reprogrammable MACRO and Hot Key 
program. A program which can st;md on 
its own, or be tied to ZING! You can 
train ZINGlKevs (n accomplish the tnosl 
annoyinglv repetitive tasks in a much eas- 
ier fashion. Plus, ZINGlKrys allows you to 
retrieve commands and reuse them, as 
well as the ability ID PKOtd mouse mmc- 
ment* and use them with the prrss of a 
key. Shipping now for; 549.95 



ZJNGiSpeU 




As (he name Implies, ZINGJSpell is g 
program which can detect misspelled 
wotds as you are typing them. A simple 
interface allows you to correct a. wuid, a 
add a word to the dictionary. You'll nevi 
need to buy another spelling checker. 
Can be used with other ZING! compo- 
nent* ur alone. $49.95 



Pleas* add S3 00 stepping ancj handling. 
!o sari oidcr 



AMIGA is a registered trademark of Commodore-AMIGA. Inc. 31*31, ZINGIKeys and ZtNG'Spell are Irademarks of Meridian Software, Inc. All rights reserved. 

Credit cards and dealer inquiries welcome. Circle 321 on Reader Service can 
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BASIC Intuition 

Use custom screens and windows to create professional-looking Amiga Basic displays, 
and discover how event trapping lets you keep your programs on track. 



A 



By Bryan Catley 

central challenge for any programmer is to create pro- 
grams that allow easy input and easy viewing of output 
On the Amiga, the routines in the Intuition library let 
C and assembly-language programmers construct easily 
accessible programs. In this article 1 will show you how 
you can write BASIC programs that rival commercial 
software in their ease of" use, by using the built-in 
ieaures of Amiga Basic, and by applying event-trapping 
techniques. 

Windows and Screens 

Amiga programs communicate with users via windows. 
For instance, on the right of the Amiga Basic display is 
a half-sized window named List, which is used to enter 
new programs and to edit existing ones. Behind the 
List window is the Output window where you enter 
immediate commands and where Amiga Basic displays 
program output. All programs that require input from 
the user, and that have to display results, need a 
window. 

All Amiga windows are associated with a screen that 
defines their environment. Screens determine the maxi- 
mum resolution and the number of colors available to 
associated windows. Since Amiga Basic uses the Work- 
bench screen, its List and Output windows default to 
the resolution (640 x 200 pixels) and colors (four) of 
that screen. However, the Workbench parameters will 
not suit your needs all the time, so you can define your 
own environment by typing SCREEN number, width, 
height, depth, mode into your program. 

The first parameter of the Screen command is an 
identifying number from one to four, used by other 
commands to reference the screen. Width and height, 
measured in pixels, define the screen size. Width must 
be 640 for a hi-res screen, or 320 for low-res. The 
height must be 200 for a non-interlaced screen, or 400 
for interlaced. 

Depth specifies the number of bit-planes that are to 
be used in determining the color of each pixel on the 
screen, A bit-plane consists of an area of memory 
where each bit represents one pixel on the screen, any- 



where from 8.000 bytes (04,000 bits) for a 320 x 200 
screen to '52,000 bytes (250,000 bits) for a 640 x 400 
screen. 

Since any one bit can have only the values or 1, a 
screen with one bit-plane can only display two colors. 
However, if you add a second bit-plane, each pixel is 
now represented by two bits, and you have four possi- 
ble values representing four different colors. So, each 
time you add another bit-plane, you double the number 
of possible colors available on that screen. Each screen 
has its own set of bit-planes. Hi-res screens are 
restricted to a maximum of four bit-planes with 16 
colors, while low-res screens may have up to five bit- 
planes willi 32 colors. 

Mode is a reference number that identifies a screen's 
resolution— one for 320 x 200 non-interlaced, two for 
640 X 200 non-interlaced, three for 320 x 400 inter- 
laced, and four for 640 x 400 interlaced. A non-inter- 
laced screen has a vertical resolution of 200 pixels, 
which results in 200 horizontal lines stacked on top of 
one another. 

These 200 lines are redrawn 60 times each second on 
your monitor, resulting in a steady picture. But with 
interlacing, each time the screen is drawn with 200 
lines, things shift down half a line, and a second set of 
200 lines is drawn. This effectively provides 400 lines 
on the screen, but the price is a distinct flicker since 
the entire screen is now only being drawn 30 times a 
second. The color combinations you choose also affect 
the amount of flicker you see. 

An Open Window 

Having defined a custom screen, your program opens a 
window on screen with the Window command: WIN- 
DOW number, title, size, attribute, screentt. Again, number is 
an identifier of one or above. But be careful, one is 
reserved for the Amiga Basic Output window. Title is^- 
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Setting up your 
own custom menus 
in Amiga Basic 
means defining 
them, turning them 
on, and waiting for 
the user's 
selection. You 
define each menu, 
and the items 
within it, with a 
Menu statement. 



an optional character string displayed in the window's 
title bar. Size specifies the pixel coordinates of the 
upper left-hand and lower right-hand corners of the 
window, in the form (X,Y)-(X,Y). If it is omitted, the 
window will be full size. 

Attribute is a reference number describing the win- 
dow's gadgets. Zero means no gadgets or window 
refresh. One includes sizing gadgets, two a drag bar, 
four frontVback gadgets and eight the close gadget. 
Requiring sizable memory, 16 refreshes a window after 
it has been covered or resized. Various combinations 
may be specified by adding the appropriate values; 10 
provides a drag bar and close gadgets. The command 
defaults to 31. Screen* refers to the indentification 
number of the screen associated with the window. 

When a window is opened, it is drawn on top of 
other windows already present on the screen, and 
becomes the current window. All future output will be 
directed to this new window. However, you may specify 
a different current window by issuing the command 
WINDOW number, where number identifies the new 
window. The referenced window will move to the front. 
If you wish to make a window current without moving 
it to the front, use the WINDOW OUTPUT number 
command. 

Active and current windows are not necessarily the 
same. An active window is the window that receives key- 
board input. You make a window active by clicking in 
it; note how the title bar changes. When you are fin- 
ished with a window or a screen, be sure to close it with 
WINDOW CLOSE number or SCREEN CLOSE number to 
free allocated memory for other purposes. 

Custom Menus 

Setting up your own custom menus in Amiga Basic 
means defining them, turning them on, and waiting for 
the user's selection. You define each menu, and the 
items within it, with a Menu statement: MENU menu- 
number, item-number, status, title. Menu-number identifies 
the menu, the left-most menu being number one, the 
next number two, and so on. Item-number identifies 
the item within the menu. Zero specifies the menu 
header, one is the First item, two is the second, etc. The 
status numbers, zero to two, respectively disable a menu 
item, enable it or enable it with a check mark. The 
menu's title may be omitted from a previously defined 
item to change the status. If set to null (""), it turns off 
that menu. Grouped together, these statements define a 
complete set of menus. You put them in the program 
before they are actually required. 

You activate menus with the MENU ON command. At 
this point, however, you must decide whether you want 
to poll the function MENU(O), or use event trapping to 
wait for the user to select a menu item. In polling, the 
function MENU{0) returns a until a menu item is 
selected, then returns the number of the selected menu. 
To set up a polling loop type: M = 0:WHILE M = 0:M = 
MENU(0):WEND. 

When execution falls through to the next statement, 
the user has selected a menu item, and M contains the 
menu number. It then becomes a simple matter of 



using an ON M GOTO/GOSUB statement to branch to 
the routine that handles that menu. Once in the menu 
routine, vou can use the function MENU(l) to deter- 
mine which item was selected, for example 
I = MENU(l). As before, you can use this value as the 
object of an ON. . .GOTO/GOSUB statement to reach 
the desired item routine. When finished, you would 
probably return to the polling loop described above. 

Event Trapping 

The event trapping approach is more involved than 
polling, but it provides almost limitless flexibility. 
Either before or immediately following the MENU ON 
statement, type ON MENU GOSUB label. The label 
names a subroutine that will automatically be branched 
to every time the user selects a menu item, regardless of 
what else may be going on. The subroutine provides all 
the necessary processing, and must end with a RETURN 
statement. 

Once the ON MENU statement has been executed, 
Basic checks to see if a menu item has been selected 
after the execution of every statement. If so, the pro- 
gram branches to the menu-handling subroutine. Upon 
completion of that routine, the RETURN takes you 
back to the statement following the one that was execut- 
ing when the menu item was originally selected. Using 
this approach, the program can continue processing or 
it can wait for a menu item to be selected. Hence, you 
trap an event — the user choosing a menu item. 

If your program doesn't have to do processing while 
waiting for the user to select a menu, you can put the 
program to sleep with the statements: X = 1: WHILE 
X= 1:SLEEP:WEND. The result is similar to the polling 
technique, but SLEEP is a special statement designed 
specifically to work with the ON MENU GOSUB label. 
Whereas the polling method is continually using CPU 
cycles while waiting, SLEEP conserves system resources. 
The program shuts itself down until a menu item is 
selected, then it comes back to life. Once the RETURN 
is issued, the program will go back to "sleep," unless 
the variable X has been changed. In this case, control 
will fall through to the next statement. In the multitask- 
ing environment of the Amiga, this is the preferred 
approach since other tasks will have more resources 
available to them while the program waits for input 

At some point you'll want to return to the four stan- 
dard Amiga Basic menus. Unless you issue the MENU 
OFF and MENU RESET statements, your custom menus 
will remain after the program has finished. 

Mouse Handling 

The right mouse button controls the menus, but Amiga 
Basic also provides methods of checking clicks made 
with the left button, and determining the screen coordi- 
nates of the pointer when the clicks are made. There is 
no set-up, but like menus, you may poll or use event 
trapping. The function MOUSE(O) returns a zero until 
the left button is pressed; at that point, MOUSE(l) 
returns the X-coordinate of the pointer, while 
MOUSE(2) returns the Y-coordinate. 

The polling technique is as simple as:^ 
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Nimbus presents the first accounting program made 
exclusively for small businesses using the Amiga computer 



usiness, 



The easy new accounting program for man- 
agers of small businesses who bate to do 
accounting. With all the other record keeping 
programs, you have to learn accounting. With 
Nimbus, yon just start. 

It's available now — 

If your dealer can't deliver it immediately, 
give us a call, 

SIMPLE ACCOUNTING HAS ARRIVED 

If you don't care how computer software 
works, only that it does work, this program 
is for you. 

Nimbus 1 does the accounting, you run 
your business. 'Hie pain of accounting is gone. 

WHAT YOU NOW KNOW ABOUT 
ACCOUNTING IS ENOUGH. 

No enormous manuals here — our 
instruction booklet is only 12 pages long. 
The difference is dramatically easier, more 
enjoyable — even fun. 



RECO,|D o K EE p ING 
s MAL fe BUSINESS 




AT LAST: ACCOUNTING ANYONE CAN DO 

This is the first complete small business 
accounting software designed to take full 
advantage of the genius of the high speed 
Amiga computer. 

This is lnstructionless Accounting 

NIMBUS 1 requires no computer 
knowledge, no bookkeeping expertise. All of 
its functions are simple, self-explanatory, 
automatic — mi fast. It's as easy as doing 
your checkbook. But don't confuse it with 
simple home budget programs. 

NIMBUS 1: 

first, fastest and the most Fun 

With NIMBUS 1, all the accounting 
functions are running concurrently. You just 
click on the mouse and move into a new 
function. Printing does not delay or interfere 
with other functions. 

The screens are uncluttered, using colors 
from the Amiga pallet. Amiga dealers find 
that demonstrating accounting with 
NIMBI'S 1 on the Amiga computer is 
actuallv fun. 



run your Own numbers On 
NIMBUS 1 Today 

'litis is software you 
can use right now. 
Visit your Amiga dealer 
and try- it. If NIMBUS 1 
is not in stock, call us 
collect, We will rush 
a copy to you and your 
dealer. 

bus for the name of the dealer 
nearest you. (619) 756-5756 

Cost: only $149.50 complete with its executive xippered notebook 
You can order by phone 

Circle 324 on Header Service card. 



Features Of The new 
program include: 

General, receivable and payable accounts are all 
interactive. 

Built-in ready to run chart of accounts and 
reports. 

Accounts kept on a cash basis. You know when 
customers pay you, not when they are supposed 
to. 

Equity and retained earnings accounts 
maintained automatically. 

Automatic computing of month-end and year- 
end closings. 

Prints invoices one at a time immediately, or 
later in a batch. 

Do three things at once. Each function has its 
own screen and you have instant access to each. 

All printing done in background, so you 
continue without interruption as your printer 
turns out reports. 

Daily, weekly, monthly and annual on-screen 
status reports. 

Programs and data require only one disk. 

Four color WYSIWYG input screens can be 
edited at any time. Make changes easily without a 
separate journal. 

No customer or vendor numbers to key in. One 
keystroke and one mouse-click gets any name 
from hundreds in less than half a second. 

Automatic pop-up mini-menus guide users 
through each function. 

Balance sheet, income statement, accounts 
receivable and accounts payable aging/status 
reports printed any time and automatically at end 
of month. 

Sold without copy protection for user 
convenience. 
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TO Box 1433 

Rancho Santa Fe, California 92067 

(619) 756-5756 




WHILE MOUSE(0) = 0:WEND :'Wait for click 
X = MOUSE(l):Y = MOUSE(2) :Tick up X and Y 
'coordinates 

Event trapping for the mouse is almost as easy: 

MOUSE ON:ON MOUSE GOSUB label :'Set up event 

'trap 

N = 1:WHILE N = l:SLEEP:WEND:'Go to sleep till click 

MOUSE OFF:END:'Quit when N<rl 

You can't trap keyboard events in Amiga Basic, you can 
only poll them. It is your responsibility to check for 
and handle special keys including the Return key. The 
polling may be performed with: X$ = "":WHILE X$ = 
"":X$ = INKEY$:WEND. The Speech Demonstration 
program that comes with Amiga Basic contains a good 
example of keyboard polling and mouse event trap- 
ping. Of course, you can always use the INPUT state- 
ment to control keyboard input. 

Keep On Trappin' 

Event trapping is not restricted to menus and the 



Listing 1. BAS.Intuition. 



'medium -res screen with 8 colors, 
'creating a window on the screen, 
'name of the first menu. 

'only option under the first menu 
'name of the second menu. 



SCREEN 1,640,200,3,2 

WINDOW 2,"Tem plate",, 16,1 

MENU 1,0,1, "Project" 

MENU l,l,l,"Quit" 

MENU 2,0,1, "Gadgets" 

MENU 2,1,1, "Print 0K/Cancel" 

MENU 2,Z,l,"String Gadget" 

MENU 3,0,0,"" 'menus 3 AND 4 are null menus-use to 

MENU 4,0,0,"" 'cancel the BASIC Run and Windows menus. 

ON MENU GOSUB MenuHandler 'identifies the menu-event trap routine. 

MENU ON 'activates the menus you defined. 

x=l: WHILE x=l:SLEEP:WEND 'program waits for input until x changes. 

Endit: 'Before ending the program, close 

WINDOW CLOSE 2 'everything you opened and reactivate the 

SCREEN CLOSE 1 'BASIC menus. NOTE-Don't end a program 

MENU RESET 'from a subroutine-end from main routine. 

END 



MenuHandler: 
MENU OFF 

ON MENU(0) GOSUB Menul, 
MENU ON 
RETURN 



Menu2, 'which menu was chosen? 



Menul: 'Menu 1 has only one option— the Quit option. 

x=0 'This deactivates the menu event trap and 

RETURN 'causes the program to execute the Endit routine. 

Menu2: 

ON MENU(l) GOSUB M2iteml, M2item2 'which item from menu2? 
RETURN 

M2iteml: 'example OK/Cancel requester. 

WINDOW 3, "Program Request",(20O,90H5Q0,15O),O,l 
LOCATE 2,1 

PRINT "Make sure your printer is on-line" 'requester message. 
GOSUB GadgetMake 

ON MOUSE GOSUB OK Handler 'identify mouse-handling routine. 
MOUSE ON 'turn on mouse trapping. 

z=l:WHILE z=l:SLEEP:WEND 'wait for a mouse event. 

WINDOW 2 'make "Template" current window, 



Listing continued on p. 40 



mouse. BREAK ON:ON BREAK GOSUB provides a 
means of receiving control when the user presses 
CTRL-C, and is used to terminate a program in mid- 
stream. When using animation, COLLISION ON:ON 
COLLISION GOSUB provides a method of detecting 
and handling collisions of two graphics elements or of 
a graphics element with a window border. With TIMER 
ON:ON TIMER(n) GOSUB the named routine is 
branched to automatically every n seconds. ON ERROR 
GOTO lets you specificy a routine to receive control 
when a fatal error occurs. The routine must terminate 
with a RESUME statement. 

Events may be turned on and off with event ON and 
event OFF statements, but you can also issue event 
STOP statements. STOP temporarily turns off the trap 
for that event, but BASIC remembers if the event 
occurs, and the named routine is given control the next 
time event ON is issued. 

Putting it all Together 

The BAS.Intuition program exemplifies how to com- 
bine your own screens, windows and menus into one 
program. The program also contains routines that cre- 
ate an OK/Cancel requester and a string-input gadget 
from Amiga Basic. Studying it will show you how all the 
commands discussed in this article work together. The 
program may also serve as the basis for your own pro- 
gram by demonstrating how you use input from menus, 
the mouse, gadgets and requesters to channel the flow 
of control in a program. 

The program is well-documented with comments, so I 
won't bore you with a line-by-line description. I will 
only point out a few important items. First, you, the 
programmer, should always know at what point the 
program is waiting for a mouse click or a menu selec- 
tion, and you should be prepared to handle these 
events. You must also keep the user from performing 
actions that are not permitted at certain points. The 
event OFF statements are just as important as the event 
ON statements: Use them to restrict the user to valid 
options only. 

Note also how event trapping works. By using the 
SLEEP command in WHILE loops, you are setting up a 
method that allows you to either stay in the loop or 
branch out. For instance, the only menu-handling rou- 
tine that changes the value of X, and thereby causes the 
program to drop through to the exit routine, is the one 
that handles the Quit option. All other menu routines 
return to the WHILE loop with X unchanged. You 
decide when to return to a WHILE. . .SLEEP loop and 
when to fall through. 

This program is a good demonstration of how to cre- 
ate an Intution interface for your Amiga Basic pro- 
grams. You can improve it by improving the editing 
capabilities of the string gadget or by using BOBs and 
collision detection to determine where the mouse was 
clicked in requester gadgets. Use it as a template to cre- 
ate programs like the pros.D 

Address all author correspondence to Bryan Catley, do 
Amiga World Editorial, 80 Elm St., Peterborough, NH 03458 
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Release The Graphic Designer 

In You With 
PrintMaster Plus 





mi 



Unison World 

2150 Shattuck Avenue, Suite 902 

Berkeley, California 94704 

(415) 848-6666 

Unison World is a division of 
Kyocera Unison, Inc. 



Time and time again, you've 
wanted to create exciting banners, 
posters, greeting cards, stationery, 
or calendars. If only you had the 
time and the budget to complete 
these projects yourself, you would! 
Well, now you can. Thanks to the 
creative power in PrintMaster Plus 
— the innovative new graphic 
design software from Unison World. 
In just a matter of minutes, you'll 
be able to see your great graphic 
ideas in print! 



A Partner in Design 

Jump into the creative process 

^.. anywhere you 

'^S -^seggagg : C] choose — 
graphics, 
format or copy. 
PrintMaster 
Plus is 
exceptionally 
flexible. And 
with over 
100 pieces 
of clip art, 
10 type fonts 
in 5 styles, 
and 11 border designs to select 
from, you'll have an endless 
variety of creative choices to make. 

Best Of AH ... The Price! 

PrintMaster Plus is very affordable 
graphic design software. So now 
you do have the time and the bud- 
get to develop the undiscovered 
graphic designer in you! 
To get your copy of PrintMaster 
Plus, just ask your local computer 
dealer. 

Available on MS-DOS compatible computers: 
Commodore Amiga, Atari 520 ST, 
Commodore 64/128, and Apple tl computers, 



MEMORY 
EXPANSION 

AMIGA" MEMORY 

It all began 10 years ago when Commodore 

introduced a wondrous PET Computer with 8 

Kbytes of memory. Almost immediately, Skyles 

Electric Works doubled the PET memory with an 

8 Kbyte memory addition. 

History repeals itself 10 years later with Skyles 

Electric Works offering the most complete line of 

AMIGA memories in the world. Consider for the 

AMIGA 1000: 

256 Kbyte memory, plugs into the front in 5 

seconds, iowestcost S79.95" 

512 Kbyte memory, no pass-thru, plugs into right 

side in 5 seconds S349.95* 

512 Kbyte memory, 86 pin pass-thru, sockets to 
expand to 1 Mbyte, connector for daughter 
board to expand to 2 Mbyte, plugs into right side 

in 5 seconds S399.95* 

1 Mbyte memory, 86 pin pass-thru, connectorfor 
daug hter board to expand to 2 Mbyte, plugs into 
right side in 5 seconds $449.95 

A major manufacturers magnificent 

multitude of memories, magnanimously 

merchandised for minimal money. 

1 Mbyte Daughter board to expand above 
memories, unpopulated $99.95* 

1 Mbyte Daughter board to expand above 
memories, populated S199.95* 

2 Mbyte memory, 86 pin pass-thru, plugs into 
right side in 5 seconds S599.95* 

Add S50.00 for separate power supply for the 

above memories. 
2 Mbyte memory, no pass-thru, plugs into right 

sidein5secs $549.95' 

512 Kbyte memory, install inside, in 1 hour, no 

soldering required $249.95* 

1 Mbyte memory, install inside, in 1 hour, no 
soldering required . _. $349.95 

COMING SOON 

Consider for the AMIGA 2000: 

1 Mbyte memory, sockets to expand to 2 Mbyte, 
plugs into expansion connector inside, in 1 minute 
$449.95* 

2 Mbyte memory, plugs into expansion 
connector inside, in 1 minute $549.95* 

Consider for the AMIGA 500: 

512 Kbyte memory, plugs into expansion 

connector inside, in 1 minute $199.95* 

•Due to trade games being played by U.S. and 
Japan all prices are subject to change without 
notice. Please add $4.50, U.S. and Canada. S15 
Europe and Asia, shipping and handling. 
California residents, please add sales tax. 

For Information, Call or Write: 
1-800-227-9998 1-415-965-1735 

Skyles 
Electric Works 

231 -E South Whisman, Mtn. View, CA 94041 




Circle 370 on Reader Service card 



WINDOW CLOSE 3 'kill the requester. 

IF p=l THEN PRINT"Printing Activated" 'actions taken as result 

IF p=0 THEN PRINT"Print±ng Canceled" 'of input from requester. 

RETURN . 

M2item2: example of string requester. 

WINDOW 3, "String Gadget",(100,50H400,100),0,l 'gadget window. 
LOCATE 2,1 
PRINT "Enter Filename" 
LINE (20,15M280,25),,b 
LOCATE 3,4:c=0:file$="":x$="":WIND0W 3 
WHILE x$OCHRS(13) AND c < 15 
xS=INPUT$(l) 
IF xS> CHR$(32) THEN 
PRINT x$; 
fileS=fileS+x$ 
c=c+l 
END IF 
IF x$= CHR$(8) AND c>0 THEN 
ffle$=LEFT$(ffle$,c-i) 
PRINT CHRS(8); 
c=c-l 
END IF 
WEND 

GOSUB GadgetMake 
ON HOUSE GOSUB OK Handler 
MOUSE ON 

z=l:WHILE z=l: SLEEP'WEND 
WINDOW 2 
WINDOW CLOSE 3 
IF p=l THEN PRINT 
IF p=0 THEN PRINT 
WINDOW 2 
WINDOW CLOSE 3 
RETURN 

GadgetMake: 

LINE {5O,30X12O,45),3,b 'create action boxes. 

LINE (175,30H245,45),3,b 

LOCATE 5,11:PRINT "OK 

LOCATE 5,24:PRINT "Cancel" 

RETURN 

OK Handler: 
MOUSE OFF 

IF WINDOW(O) <> 3 THEN WINDOW OUTPUT 3:M0USE ON-RETURN 
'clicked in wrong window. 

m-MOUSE(O) 'we know the mouse was clicked- 

'this is FOR the NEXT line. 
A = MOUSE(3):b»MOUSE(4) 'mouse coordinates at 

'MOUSE(O) FUNCTION call. 
IF (A > 50 AND A < 120) AND <b > 30 AND b < 45) THEN GOSUB 0K:RETURN 
IF (A > 175 AND A < 245) AND <b > 30 AND b < 45) THEN GOSUB Cancel:RETU R N 
MOUSE ON 
RETURN 'clicked in window but outside requester boxes. 

OK: 'clicked in OK box. 

LINE (50,30M12O,45),3,bf 'inverse the box. 

p=l 'flag indicates selected box. 

z=0 ' turn off mouse trapping. 

RETURN 



"Loading Hie: ";file$ 
"Aborting file: ";flle$ 



Cancel: 

LINE (175,30H245,45),3,bf 

p=0 

z=0 

RETURN 



'clicked in cancel box. 
'flag is different from above. 
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For a computer as extraordinary as the Amiga™ 
you need a magazine that can match its excellence, 
AmigaWorld. 

AmigaWorld is the only magazine which provides you 
with ideas and information to get maximum performance 
from the Amiga's tremendous power and versatility. 

Each issue gives you valuable insights to boost your productivity and 
enhance your creativity. 

Whether you choose the Amiga as a serious business tool for its speed and 
multi-tasking capabilities ... or for its superb graphics, drawing, color, (over 4,000 
colors), and animation ... or for its state-of-the-art music and speech ... or for 
its scientific and CAD abilities, AmigaWorld can help you achieve superior results. 

With its timely news features, product announcements and reviews, useful 
operating tips, and stunning graphics, AmigaWorld is as dynamic as the market 
it covers. 

Don't wait! Become a charter subscriber and save 25% off the basic subscrip- 
tion rate and nearly 37% off the cover price. Return the coupon or the attached 
card. For immediate service, call toll free 1-800-258-5473. In NH, call, 1-924-9471. 



-Vilr. 



I want to discover the full potential 
of this powerful machine. And save 
25% off the basic rate as a charter sub- 
scriber. Enter my one year subscription 
(6 issues) to Am/'g/aWor/o'for the low 
price of $14.97. If I'm not satisfied at any 
time, I will receive a full refund — no 
questions asked. 

□ Payment Enclosed □ Bill Me 

Name 



Address 
City 



■ Zip 



State 



Please make check payable to AmigaWorld. 
Canada and Mexico $17.97, Foreign Surface 
$34.97, Foreign Airmail $69.97. 1 year only, 
US funds drawn on US bank. Please allow 
6-8 weeks for delivery. 

AmigaWorld 
P.O. Box 868, Farmingdaie, NY 11737 

Amiga is a trademark ol Commodore-Amiga, Inc. 
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BRINGING THE WORLD OF AMIGA™ PRODUCTS TO YOU. 




AMIGA 1010 3.5" DISK DRIVE 

(Call For Current Price) 



AMIGA 1000 COMPUTER 
AMIGA 1080 COLOR MONITOR 

(Call For Current Price) 





AMIGA MODEM 1200 RS 

(Call For Current Price) 



AMIGA 5.25" DISK DRIVE WITH TRANSFORMER SOFTWARE — Available Now! 
CALL FOR PRICE AND AVAILABILITY OF SIDECAR AND GENLOCK 




AMIGA 1 
500 & 2000 1 

CALL! 


1 FUJI 1 
DS/DD Disks 

Box of 10 Disks 

$19.99 1 


OKIMATE20 

with 
Interface 

$199 ■ 


SONY 1 
DS/DD Disks 

Box of 10 Disks 

$28 ■ 


Modem Special 

300/1200 Baud 

On-Line Software 

Cable 

$199 1 



Free Blue Label Shipping 



* On all software orders over $100 to destinations east of the Rocky Mountains. This is two-day delivery from shipping date. 



SOFTWARE 



ABSOFT 

AC/Basic $234 

AC/Fortran $234 

ACCESS SOFTWARE 

Leader Board $ 27 

Tournament Disk $ 16 

10th Frame $ 2B 

ACCOLADE 

Mean 18 $ 27 

Famous Course Disk . $ 21 
Famous Courses 
Volume 2 J 17 

ACS 

Grade Manager... $ 69 

QuizMaster Call 

ACTIVISION 
Champ Basketball $ 29 

Gamemaker $ 48 

Gamestar Titles Can 

Hacker $ 29 

Little Comp, People... Call 

Music Sludio $ 40 

Portal $ 29 

Shanghai $ 29 

ToneTown $ 29 

ADDISON-WESLEY 
Manuals Call 

AEGIS 

FREE T-Shirt with any two 
Aegis Products 1 ! 1 



Animator/Images . 

Art Disk 

Diga 

Draw Plus 

Images 

Impact 

Sonix 

Videoscape 3D . . 
AMIGA 

Cross Dev. Sys 

MindWalker 

1.2 Update 

ARTWORX 

Bridge 4.0 

Strip Poker 

BANTAM 

AmigaDOS Express. 

DOS Manuals 

BETHESDA 

Gridiron! 

BROWN WAGH 

TV Text 

Publisher 1000 

Zuma Fonts 

1.2. of 3 

BYTE BY BYTE 

Financial Plus 

InfoMinder 

CLTD. 

JetSel 

JetSet Fonts 

CAPILANO 

Logic Works 

Logic Works Jr. 

CENTRAL COAST 

DISK 2 DISK 

DOS 2 DOS 

CHANG LABS 

Accts Payable 

Accts Receivable 

AR/AP/GL 

General Ledger 



$ 89 
$ 21 
$ 56 
$169 
$ 31 
$ 61 
$ 57 
$149 

. $ 89 
. $ 38 
. $ 14 

..$ 26 
..$ 32 

..$ 25 
. S 16 

S 44 

$ 79 
Call 

$ 26 

S250 
$ 69 

Call 
Call 

$159 
$ 79 

Call 

$ 45 

$109 
$109 
£219 
$109 



COMPUMED 

Hacker Package $ 35 

Mirror $ 35 

COSMI 

Super Huey $ 27 

CREATIVE SOLUTIONS 

MultiForth $134 

DARK HORSE 

Chess Mate $ 25 

DELTA RESEARCH 

J-Forth $ 89 

DELUXE HELP 

Deluxe Help.. $ 20 

DIGITAL CREATIONS 

D'Buddy $ 58 

Digital Link $ 49 

Gizmos 2.0 Call 

DIGITAL SOLUTIONS 
LPD Series „ Call 

DISCOVERY 

Grabbil $ 24 

Exactly! $ 19 

Key Genie Call 

Marauder II $ 29 

EAGLE TREE 
Butcher $ 25 

ELECTRONIC ARTS 

Adv Constr. Kit $ 27 

Archon $ 27 

Archon II $ 27 

Arctic Fox $ 27 

Arts Part II $ 19 

Auto Duel $ 35 

Bard's Tale $ 32 

Biack Cauldron $ 29 

ChessMaster 2000... $ 30 

Deluxe Music $ 65 

Deluxe Paint II $ 85 

Deluxe Paint Utility $ 19 

Deiuxe Print $ 65 

Deluxe Print Utility $ 19 

Deluxe Video 1.2 $ 91 

Donald Duck $ 19 

DPainl Data Disk $ 25 

DPnnt Data Disk $ 25 

Earl Weaver Baseball 

(June) $ 35 

Financial Cookbook $ 33 

Instant Music $ 32 

Instant Music Data S 25 

Intellitype $ 35 

King's Quest 1.2.3 Call 

Marble Madness $ 33 

Mew Tech Col. Book,. $ 17 

Ogre $ 27 

One on One $ 27 

Police Quest $ 32 

Quizam $ 25 

7 Ciliesof Gold £ 27 

Skylox $ 27 

Starfleet I $ 36 

Ultima III $ 39 

Ultima IV $ 31 

Winnie the Pooh $ 26 

EPYX 

Rogue $ 25 

Summer Games $ 27 

Temples of Apshai $ 28 

World Games $ 27 

FELSINA 

A-Talk Plus $ 79 

FIREBIRD 

Guild of Thieves $ 32 

Pawn $ 32 

FIRST BYTE 
First Shapes $ 34 



Kid Talk $ 34 

Math Talk $ 34 

Speller Bee $ 34 

FINALLY SOFTWARE 

Dr. Xes $ 39 

Nancy $ 45 

Phaser $ 69 

Senor Tutor Call 

Talker $ 54 

GIMPEL 

Lint $ 85 

GO AMIGO 

Printer Drivers Call 

GOLD DISK 

Gold Spell $ 38 

Page Setter $109 

GRAFOX OF ENGLAND 

Logistix $144 

INFINITY 

Galileo $ 79 

Grand Slam Tennis... $ 3B 
INFOCOM 

All Titles Available Call 

INOVATRONICS 

Power Windows $ 65 

INTERACTIVE ANALYTIC 

Expert System Kit $ 55 

Explorer $ 40 

ISM 

Surgeon $ 44 

JAGWARE 

Alien Fires Call 

JDK IMAGES 

Pro Video CGI Call 

Font Library 1 $ 79 

Font Library 2 $ 79 

JENDAY 

Conv. w/Comp S 24 

JHM 

Talking Color Book.... S 24 
KENT ENGINEERING 

MacroModem $ 49 

LATTICE 

C - Regular $169 

C - Professional $284 

dbC III Library $119 

Make Utility $ 99 

Panel £149 

Screen Editor £ 84 

MANX 

Aztec C—Comm Call 

Aztec C — Devel Call 

Aztec C— Prof $169 

MARK OF THE UNICORN 
Hex $ 31 

MAXISOFT 

Maxiplan £ 99 

Maxiplan Plus... $130 

MERIDIEN SOFTWARE 
Zing S 59 

METACOMCO 

Assembler., Call 

Lisp $154 

Make S 57 

Pascal S 70 

Shell S 59 

Toolkit £ 39 

METADIGM 
MetaScope $ 79 

MICRO ILLUSIONS 

CAD System Call 

Discovery, $ 25 

FearyTale Call 

MICROPROSE 

Gunship $ 28 

Silent Service $ 28 



MICROSMITHS 

Fast Fonts Call 

TxEd $ 32 

MICROSYSTEMS SW 

Analyze 2.0 $ 99 

BBS-PC ..$ 62 

Flipside $ 31 

On-line $ 46 

Organize $ 63 

Scribble $ 63 

MILES 

Quintette's Call 

MIMETICS 

SoundScape $130 

MINDSCAPE 

Balance of Power $ 32 

Bratacus $ 35 

Def of the Crown $ 32 

Deja Vu $ 32 

Halley Project $ 30 

Keyboard Cadet Call 

King of Chicago $ 34 

Racter $ 28 

SAT Preparation $ 52 

S.D.I $ 34 

Sinbad $ 34 

Uninvited $ 35 

NEW HORIZONS 

Flow $ 74 

ProWrite $ 91 

NEWTEK 

Digi-Paint $ 49 

DigiView 2.0 Call 

NORTHEAST SOFTWARE 

Order Call 

Publisher Call 

PAR SOFTWARE 

Par Home $ 50 

Par Real $ 99 

PECAN 
Pascal Powersys $ 89 

PROGRESSIVE 

CLI-Mate $ 25 

Superbase $ 85 

Vizawrite $ 85 

SEDONA 
Money Mentor S 74 

SOFTWOOD 

Mi Amiga File $ 62 

Mi Amiga Ledger $ 62 

SPECTRUM HOLOBYTE 
Gato Call 

SUBLOGIC 

Flight Simulator £ 32 

Jet $ 32 

SUN RIZE 

City Desk $110 

Desktop Artist #1 $ 23 

TAURUS 
Acquisition $209 

TCI 

Editor Call 

Examples Call 

Grid Database Call 

Kermit Call 

Modula II— Comm. ... $211 

Modula II — Devel $112 

Modula II — Reg $ 65 

THE OTHER GUYS 

Keep-Trak $ 99 

Omega File $ 60 

TIGRESS 
Diskwik £ 36 

TRUE BASIC, INC. 

True Basic $109 

9 Libraries (each) $ 39 

Runtime $109 



TYCHON 

Printz $ 55 

UNICORN 

Read & Rhyme $ 35 

Kinderama $ 35 

Decimal Dungeon $ 35 

Fraction Action S 35 

UNISON WORLD 

Art Gallery I, II $ 20 

Printmaster Plus $ 33 

VERSASOFT 

dBMAN $106 

VIP TECHNOLOGY 
Professional £129 

WORDPERFECT INC. 
WordPerfect Call 

ZEN SOFTWARE 
System Monitor $ 39 

ZIRKONICS 
Prof.Text Engine $ 80 



HARDWARE 



ACCESS ASSOCIATES 

Alegra512K $299 

AMIGA 

A1000CPU Call 

External 3.5" Call 

Monitor Call 

Transformer Call 

Genlock..... Call 

Modem... Call 

ANAKIN 
Easyl Call 

ANCHOR AUTOMATION 
Omega 80 $165 

APPLIED VISIONS 
Futuresound $144 

BYTE BY BYTE 
TIC S 49 

EPSON 

EX-800 Printer £499 

EX-8OOC0I. Option... £ 80 
EX-800 Col. Ribbon... £ 17 
JX-80 Ribbons $ 17 

GO AMIGA 

Printer Cables $ 25 

Modem Cables $ 25 

Disk Head Cleaner.,.. $ 15 

30-DiskCase $ 10 

Mousepad £ 10 

Sony Monitor Cable... £ 35 

GOLDEN HAWK TECH. 
MIDI Gold $ 69 

IDEAS CREATED 
Jitter Rid 5 15 

MICROBOTICS 

256KRAM £ 84 

Mouse Time Call 

Starboard 2MB Call 

Other Sizes Available 

MIMETICS 

Audio Digitizer $ 89 

MIDI Interface $ 45 

OKIDATA 

Oki 20 Color Rib S 10 

Oki 20 Black Rib $ 9 

SUN-RIZE 
Perfect Sound £ 69 

SUPRA CORP. 
Hard Drives Call 

This is 3 selection from the over 
425 Amiga products we have in 
stock, New products arrive every 
day — please call lor latest price 
and availability information. 



",: 



Send Mail Orders to: GO AMIGO 508 Waverley St., Palo Alto, CA 94301 
(Money Order, Cashier's Check, or Qualified P.O. only) 



^ 800-BE-AMIGA 

In California: 800-843-2842 



Customer Service: 41 5-322-0686 

Delivery subject to product availability • Pnces subject to change • Circle 320 on Reader Service card. Amiga is a trademark ol Commodore-Amiga. Go Amino ,s ,n no way associated with Commodore-Amiga. 



SHIPPING INFO: We ship UPS ground. On orders less than S1O0, shipping is S3 per item (limit S6). 
For software orders over $100, FREE UPS 2nd Day Air shipping. Call tor hardware shipping costs. 
RETURN 4 REFUND POLICY: Ail returns must have an RMA-#. Call Customer Service and request 
a HMA-K Defective merchandise under warranty will be repaired or replaced. We do not offer relunds 
lor defective products or lor products that do not perform satisfactorily. We make no guarantees for 
product performance. Any money hack guarantees must be handled directly with the manufacturer. 



Tangible 
Graphics: 

Capturing Amiga 
Screens on Paper, 
Film and Videotape 



Without doubt, the best medium 
for viewing Amiga graphics is 
an analog RGB monitor — such 
as the Amiga 1080 monitor. 
It's very inconvenient, however, 
to lug an Amiga system 
around with you every time 
you need to reproduce Amiga 
graphics. What you need 
is hardcapy — printouts, slides, 
or videotape — of what appears 

■our Amiga monitor. 
What follows are short, practical 
pieces on how to transfer 
Amiga images from your screen 
to paper, film and videotape. 



Putting It on Paper 

If you want to print Amiga screens, you must have a 
graphics-capable printer and a driver that supports it. 
The Amiga's system software has drivers for a number 
of graphics printers; you select the driver you need in 
Preferences. 

The Amiga doesn't have a screen-dump program 
built into its system software. Instead, Commodore 
includes a utility program called GraphicDump with ver- 
sion 1.2 of Workbench. When you run GraphicDump 
by double-clicking on its icon, it pauses for 10 seconds 
to allow you to bring the screen you want to print to 
the front of the Workbench. Then, using the printer 
driver you selected from Preferences, GraphicDump 
prints out your Amiga screen. 

Don't be fooled by the name GraphicDump: Every- 
thing, including text characters, will be printed by the 
program. Actually, this isn't surprising because every- 
thing she Amiga displays is bitmapped graphics. Unlike 
many other computers, the Amiga doesn't have a sepa- 
rate text mode. 

You can, to some degree, control the results of a 
GraphicDump printout by playing with the graphics 
printer settings in Preferences. You can use the hori- 
zontal and vertical settings, the margin and page-length 
settings to alter the size of your printouts, and, if you 
choose the black-and-white option, you can control 
which colors print as black and which print as white by- 
changing the Threshold setting. (See Morton Kevelson's 
Graphic Hardcopy and the Amiga, AmigaWodd, March/ 
April '87, page 36, for details on controlling printed 
output.) Experimentation will reveal what settings work 
best for you. 

Bring 'Em Back Alive 

What screen dump programs like GraphicDump can't 
do is allow you to modify the screens you print. To 
modify screens before printing them, you first have to 
capture them to disk as Amiga picture files. You can 
then load these pictures into an Amiga paint program, 
such as DeluxePaint II or Graphicraft, and modify them 
as you would any Amiga picture. You can then print 
the modified picture with the print routines built into 
the paint programs themselves. 

Grabbit from Discover) Software and Window Print 
II from Computer Toolsmith arc two commercial pro- 
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grams that let you capture screens as well as print 
them. They let you save screens in the Amiga IFF pic- 
ture format, allowing you to load the pictures into any 
Amiga paint program. Once you've captured a screen, 
you don't necessarily have to print it. You can use a 
paint program (or the public-domain program See_ 
ILBM) to display it for a screen shot or for videotaping. 
If you intend to produce hardcopy images of your 
Amiga screens, you'll need to be able to capture the 
screens to disk. — The Editors 



GraphicDump 

Commodore-Amiga 

Included with Amiga Software Enhancer Kit 

(Kickstart and Workbench 1.2) 



C rabbit 

Discovery Software 
262 South 15th Street 
Suite 400 
Philadelphia, PA 19102 



Window Print II 
Computer Toolsmith 
1055 Crest View Road 
Vista, CA 92083 



Successful Screenshots 
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Photo 1. Typical color 
saturation test made 
with DeluxePaint. 
When making an 
exposure, use your mouse 
to paint to the 
corresponding f-stop. 



Reproducing colors accurately— getting the right color 
saturation — is one of the keys to taking successful 
screen shots of the Amiga screen. To control the color 
saturation of your slides and photographs, you need 
only take the time and effort to discover the optimal 
exposure settings for your camera-computer 
combination. 

To control the color in your screen shots, you must 
perform a saturation test of your monitor screen. To 
perform the test, you first make a test target like the 
one in Photo 1, Note that the lest pattern pictured here 
has a range of colors, a grey scale and boxes you use to 
indicate the f-slop of a particular shot. You can create 
such a target with any Amiga paint program. 

Shooting Star 

Once you have your target, set your camera up in front 
of the screen and darken the room as much as possible. 
Using a moderate-speed film like Ektachrome 200 and a 
shutter speed of one second, take a series of seven 
shots of the target using various mid-range f-stops on 
your camera. I take shots between f3.5 and f9. 1 find 
that these lens openings give me the sharpest picture. 



When making an exposure, be sure that your mouse 
pointer is positioned over the corresponding f-stop on 
the target. 

When your slides or photographs return from the 
processing lab, you will have a series of photographs in 
which the color saturation ranges from dark to 
bleached. If you positioned the mouse pointer correctly, 
the f-stop of each of the exposures should be evident in 
your pictures. Simply choose the picture that yields the 
best results and use the corresponding f-stop in all 
future screen shots. Note, however, that if you change 
anything about the exposure — film, shutter speed, mon- 
itor controls, processing lab, or distance between cam- 
era and screen — you will most likely change the optimal 
f-stop and have to perform another series of test shots. 

Hints and Tips 

I strongly recommend Ektachrome 200 film for screen 
shots; it sparkles and does the best job of nearly every- 
thing in the palette. I was surprised at how bad 
Kodachrome looked— it must be allergic to Amigas! 

Forget your light meter unless it will average light off 
the screen. My high-tech digital light meter gave differ- 
ent results everytime I took a reading. A shutter speed 
of one second avoided the whole metering problem 
because the monitor is a consistent light source when 
averaged over that period of time. Better yet, hi-res 
flicker disappears with a one second exposure, 
although color saturation remains consistent at all 
resolutions. 

If you're a knob tweaker like me, paste a note on the 
monitor controls door that says "For slides, set all con- 
trols in the detent position." Be certain that you take 
your screen shots from the same distance you shot your 
test pattern from to avoid inconsistent results. Pay 
attention to camera alignment — a crooked slide is as 
bad as a blurry one — and try to avoid putting straight 
lines near the edges of screens you want to shoot; such 
lines will appear curved on your photograph. 

Remember, you can control the quality of screen 
shots on the Amiga; you just have to do a little testing. ► 

— Paul Beck 



Imprint and Polaroid Palette 



While you can produce acceptable screen shots with a 
35mm or larger-format camera, better quality without 
curvature distortion is available if you want to invest 
the money. For the last three years, the Polaroid Palette 
Film Recorder has been one of the best devices for cap- 
turing images from microcomputer screens. However, it 
was only available to Apple II and IBM PC users. 

Now, thanks to the company Liquid Light, and their 
Imprint system, the Amiga can be interfaced to the 
Polaroid Palette too, Imprint consists of a small hard- 
ware interface and some sophisticated (but "user- 
friendly") software that allows the Amiga to use the 
same Palette hardware developed for use with the IBM's 
CGA (four-color) graphic system, but allows access to all 
4,096 colors the Amiga can produce. 

The Polaroid Palette consists of a film recorder, a 
35mm camera back, a Polaroid 3 '/,, x 4 % instant cam- 



Professional Images 

If you need professional, reproduction-quality color prints, slides, negatives, 
and overheads of Amiga screens, contact ImageSet Corp. of San Francisco, CA. 
They produce images directly from IFF picture files and from Amiga Hold- 
And-Modify files. They can even provide you with color separations if you want 
to print full-color Amiga screens. Prices start at $9.30 for a 35mm color slide of 
an IFF picture and range up to $242 for an 8 x 10 color separation. 

— 77ie Editors 

ImageSet Corp. 

555 19th Street 

San Francisco, CA 94107 

415/626-8366 





era back, and an instant slide processor and mounting 
device. You can use Imprint and the Palette to take full- 
color 35mm slides, (instant or processed), instant color 
pictures, color transparencies or even four-color separa- 
tions of any picture (except Hold AnJ Modify) the 
Amiga can generate. This incl ides 320 x 200, 320 X 
400, 640 x 200 and 640 x <<00 in one to five bitplanes 
of color. 

An important aspect of the Imprint system is that 
interlaced images become perfectly suitable for image 
generation, regardless of the monitor you are using. 
The flicker associated with interlaced mode is not 
apparent when you use the Palette system. 

Double Exposures 

The Imprint software takes two different approaches to 
capturing the Amiga images. The main Imprint soft- 
ware works with disk-based pictures. You can use your 
favorite graphics design system to create the pictures, 
then save them to disk. When you are ready, you can 
load the Imprint software, choose the film type you are 
using, and load and expose the images. Or, you can 
choose another software option called Snapshot, which 
hides itself in the background. Then you can load and 
run a program, and with a simple keystroke, take a 
"snapshot" of what is on the screen. With these two 
methods, it becomes possible to capture virtually any- 
thing you place on the screen. 

I have used Imprint with paintings and drawings 
made with DeluxePaint II, Images, Draw Plus, Impact 
and many other commercial programs. I have used ii 
for slides of chemical formula for a technical lecture, 
slides of graphs and charts for a business presentation, 
and for making screen shots of software for various 
articles I have prepared. 

If you are using the Amiga for the generation of 
professional computer graphics, you will no doubt find 
the Imprint system a godsend. Because regardless of 
hoiv great your pictures are, if you can't use them in 
your work they are useless to you. Imprint goes a long 
way toward helping the Amiga fulfill its potential as a 
graphic design tool. — Lou Wallace 

Imprint (S495.95) 

Liquid Light Inc. 

2301 West 205th Street 

Suite 106 

Torrance, CA 90501 

213/618-0274 

Requires a Polaroid Palette 



-16 Special Issue 1987 




Available on Videotape 



Capturing Amiga 1000 graphics and text on videotape 
is simple; you hook your VCR's Video-In port to the 
composite video port on the back of your computer 
with a double-ended RCA jack and press the Record 
button on the VCR. Whatever appears on your monitor 
will appear on videotape. . .sort of. 

The problem with taping from the Amiga Video-Out 
port is that the quality of the Amiga NTSC video signal 
is not the best. Graphics and text that are crisp and 
colorful on an RGB monitor can bleed or appear 
washed out when transferred to videotape. You could 
get around this problem by purchasing the Genlock 
1300 from Commodore, which offers a better Video- 
Out than the Amiga itself, or by using expensive video 
equipment to clean up the Amiga video signal. For 
home users, however, the inexpensive solution may be 
to work around the problem. 



Happy Medium 

As one of 150 affiliates of a national videotaping oper- 
ation, I was attracted to the Amiga as a tiding and 
graphics generator for my work. I quickly discovered 
the inadequacies of the Amiga 1000 video output, with 
its bleeding and bleached color combinations. Working 
further with DeluxePaint, I discovered that some fore- 
ground/background color combinations worked better 
than others. The results of my work wifh DPaint are 
summarized in the figure below, which charts the 
results of using 12 different foreground colors in text 
characters against 13 different backgrounds. 

If you want to get the best possible results when cre- 
ating titles for your home videos, avoid the unaccepta- 
ble color combinations listed in the chart. Your videos 
will look better if you look carefully for suitable combi- 
nations. — Bill Lamed 
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AmigaDOS 1.2 CLI Commands 

By William B. Catchings and Mark L. Van Name 

Syntax Conventions and Explanatory Notes 

• Command names and keywords are shown in upper case. 

• Arguments that you must supply are in italic. 

• Optional arguments are enclosed in square brackets, e.g., [noicons]. 

• If there are several possible options at any point in a command, these are presented within 
braces ({ }) and separated by vertical bars, e.g., [a\ b | c ]. If a command allows an argument to 
repeat several times, one argument will be shown, and it will be followed by an ellipsis, e.g., srg. . .. 
These syntax symbols can be intermixed to express different alternatives; for example, the line: 
COMMAND a { b | [ KEYWORD ] c } 

says that COMMAND has one mandatory argument, a. It has one additional, optional argument, either b 
or c. If you choose c, you may optionally precede it with the word KEYWORD. 

Most AmigaDOS commands can accept their arguments in one of two ways. The first is by posi- 
tion, i.e., you must supply the arguments in the order shown. In the syntax for each command given 
above, the parameters are shown in the order in which you must specify them if you are using 
positional notation. The other alternative is to specify parameters l>v keyword. If you do so, you must 
precede each parameter with its keyword, but the parameters can be in any order. 

Many commands allow you to mix these two styles. For example, you can give the second parame- 
ter to the COPY command first, then follow it with the appropriate keyword and first parameter. 

Note that some keywords are shown as optional, while others are not. Those that are not optional 
must be supplied even when you are giving arguments by position. 

Nearly all AmigaDOS CLI commands will accept the single argument, ?. Given this argument, a 
command will display its syntax and then await input. 



File and Directory Management 

CD [ directory ] 

Sets the current directory and/or drive. If you give no 
parameters, it displays the name of the current directory. If 
you are in a subdirectory, a slash (/) will move you up one 
directory level. 

COPY [ [ FROM ] source tile } TO destination file [ ALL ] ( QUIET ] 
Copies the contents of a file or directory to another place. 
You may copy all or some of the files of a directory to another 
directory, or you may just copy one file to another. The ALL 
option causes AmigaDOS to copy the contents of all 
subdirectories as well. 

DELETE name [ name , , . ] [ ALL ] [ Q | QUIET ] 
Deletes the named files and/or directories. You cannot delete 
a directory if it contains any files. If you specify a directory 
name and ALL, AmigaDOS will delete the entire directory 
and all files and subdirectories in it and its subdirectories. 
You can list up to ten files and/or directories. Any name also 
may contain an AmigaDOS file name pattern. 

DIR [ directory ] ( OPT { A | I | Al }] 

Provides a listing of the files in the specified directory, or 
in the current directory if no name is specified. The A option 
will list the files in all subdirectories. The I option allows you 
to browse the directory interactively, one entry at a time. 

FILENOTE [ FILE \ tile COMMENT string 

Associates a comment with a file. The comment cannot be 

longer than 80 characters. 

LIST [ [ DIR ] dir or file 1 [ TO file ] 
[ { P | PAT } partem ] 
[ KEYS ] [ DATES 1 [ NODATES ] 
[ S search string ] [ SINCE date ][ UPTO date ] [ QUICK ] 



Provides information about the specified directory or file, 
or, if none is given, the current directory. The options allow 
you to control the files about which you receive information 
either with a name pattern or a search string. You can also 
control the dates after or before which you want to see files, 
as well as several other options, 

MAKEDIR directory name 

Creates a new directory with the name given. 

PROTECT [ FILE ] file [ FLAGS ] status 

Sets the protection status of the specified file. The status may 
be any combination of r (read), w (write), d (delete) or • 
(execute). AmigaDOS will not let you delete a protected file 
that does not have the d status. You can check the status from 
within programs where appropriate. 

RENAME ( FROM ] old name { TO ! AS ) new name 

Gives a new name to a file or directory. The names both 

must be on the same dfsk. 

SETOATE file date [ time ] 

Sets the date of a file to the specified date and, optionally, 

time. 

TYPE [ FROM ] flte [ t TO J destination file ] [ OPT { N | H } ] 
Displays the contents of the specified file. The N option will 
provide line numbers, while the H option will display the 
file's contents in hexadecimal format. 

Working with the Contents of Files 

ED [ FROM ] tile [ SIZE n ] 

Starts the ED screen-oriented text editor on the specified 

file. This editor reads the file into memory, and assumes a 
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memory workspace of 40K. If your file is larger, you must 
supply an adequate workspace size with the SIZE parameter. 

EDIT [ FROM ] file [ [ TO ] destination file ] 

[ WITH name ] [ VER name ] [ OPT options ] 
Starts the EDIT line editor on the specified file. You can use 
this editor to process the file sequentially, either with 
commands you enter or with commands stored in the file 
specified after the WITH option. The output goes either to 
the specified destination file or to a temporary file. The 
other options control where the editor sends its messages 
and on what lines it works. 

JOIN file file { file . . . ] AS destination file 

Concatenates from two to Fifteen files, in the order given, 

to form a new file. 

NOTEPAD [[ -Q] We] 

Runs the Notepad utility. If you give a file name, the Notepad 
will start up on that file. The -Q option stops it from reading 
fonts from the disk. 

SAY [ - M| - F] [ - R| - N] [ - S##] [ -P##] [ - xliiename\qvoted string] 
Causes the Amiga to speak the specified string or the contents 
of the given file. If you give neither, a window will appear 
and prompt you for a string. The options allow you to control 
the gender, speed, and pitch of the voice, as well as whether 
it should sound "natural" (-N) or more like a robot (-R). 

SEARCH [ [ FROM ] name or pattern ] 

[ SEARCH ] search string [ ALL ] 
Searches the specified file(s) or, if none, all of the files in 
the current directory, for the given search string. You can 
give an individual file name or an AmigaDOS file pattern. 
The ALL option forces AmigaDOS to search all of the files 
below the current directory. 

SORT [ FROM ) source file 

[ [ TO ] destination file ] 

[ COLSTART fl ] 
Does a simple sort of the specified file. This command 
performs a simple textual sort and assumes that the input 
file is a text file. It is relatively slow and cannot sort any file 
that will not fit into memory. The COLSTART option lets 
you specify the starting column for the sort, but it always 
sorts using the characters from there to the end of each line. 

Device Management 

ADDBUFFERS OF/: n 

Adds n extra buffers of 512 bytes each to the system cache 
for the specified drive. This costs memory but can improve 
disk access time. 

ASSIGN [ name [ directory ] | LIST ] 

Gives a logical name to a directory. This command is used 
most often to tell AmigaDOS to look in a different place 
(e.g., a directory in RAM:) for files (e.g., the CLI commands). 

BINDDRIVERS 

Causes the system to bind to it all of the device drivers in 
the Workbench Expansion drawer. This is part of the means 
by which you can add new devices to your Amiga. This 
command usually appears only in the -.S/STARTUP- 
SEQUENCE file on the Workbench disk. 

OISKCHANGE DFrr. 

Informs the Amiga that the disk has been changed in the 
drive specified. This command is not necessary for the 
normal Amiga 3.5 " drives. However, you must use it for other 
drives, such as the 5.25" drive, that do not detect automatically 
when the disk in them has been changed. 



OISKCOPY [ FROM ] DFi: TO DFi: [ NAME name ] 
Copies the contents of one disk to another. While they no 
longer must be of the same type (as was the case with 1.1), 
there must be enough room on the destination disk to hold 
the contents of the source. The optional NAME parameter lets 
you name the new disk. The destination disk need not be 
previously formatted. 

DISKDOCTOR DFn: 

Attempts to recover the data on a damaged disk. 

FORMAT DRIVE DFn: NAME name [ NOICONS 1 
Formats a new disk. The disk will be given the indicated 
name. Unless you specify the NOICONS keyword, AmigaDOS 
will place a trashcan icon and director)' on the disk. 

INFO 

Displays a line of information about each disk unit currently 
active on the system. If there are any files in the RAM: disk, 
this command will display a line about it also. 

INSTALL [ DRIVE ] OR: 

Makes the disk in the specified drive a bootable disk. The 

disk must have been formatted already. 

MOUNT device 

Tells the system to start using the indicated device. That 
device must have an entry in the file :devs/Mountlist on the 
Workbench disk. 

RELABEL [ DRIVE ] DFi: [ NAME ] name 

Gives the specified new name to the indicated disk. 

Basic System Management 

DATE [{date I time | date time } } [ { TO j VER } file ] 

Sets or displays the current system date and time. If you give 

no arguments, it displays both. You can set either or both 

components. 

PATH [ SHOW | directory [ directory . . . ] | ADD directory 

( directory . . . ] ] 
Tells AmigaDOS the directories in which to took (i.e., the 
"search path") for programs and commands that you attempt 
to run. With no arguments, it returns to the default search 
path (your current directory and then the directory assigned 
to C:). The SHOW argument causes it to display the current 
search path. Without the keyword ADD the list of directories 
shown replaces the old search path. With that keyword, that 
list is appended to the previous search path. 

SETMAP { map file | USA } 

Tells the Amiga to use an alternate key mapping for keyboard 

control and character display. There are new key maps for 

Germany, France, Great Britain, and Italy. If you specify 

USA, the system returns to the key map it has stored in 

ROM. 

VERSION 

Displays the current version number of the Workbench and 

Kickstart software that you are using. 

CLI and Process Management 

BREAK task [ ALL ] [ C ] [ D 1 [ E ] [ F ] 

Sets the specified attention flags (CTRL C through F) in the 
indicated task. The ALL option sets all four attention flags. 
This command is equivalent to running in that task and 
typing the corresponding control key(s). 

CHANGETASKPRI pri 

Changes the priority of the current task. The system does 

not validate this priority, so be sure to stay in the range from 
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- 5 to +5. This is most useful for causing background tasks 
to run with little impact on your main activity. 

ENDCU 

Stops the current CLI session. 

NEWCLI [ window J 

Starts a new CLI process and makes it the currently selected 
process. If a window definition is given, the window for the 
new CLI uses it. If not, the new CLI's window will have a 
standard size and position. 

PROMPT prompt string 

Changes the prompt in the current CLI to be the given string. 
This string may contain the characters %N, which will be 
replaced with the process number of the CLI. 

RUN command [ + command . . . ] 

Executes the command(s) given in the background. It creates 
a non-interactive CLI process and gives that process the 
specified command(s) as input. 

STACK [ size ) 

Sets the stack size to the indicated size. Subsequent 
commands will use the new size. If no size is given, it displays 
the current stack size. The size is in bytes. 

STATUS [ process ] ( FULL ] [ TCB J [ SEGS ] 

[ CLI | ALL ] 
Displays information about all current processes or, if a single 
process number is given, about just that process. The options 
let you decide whether to see information about only CLI 
processes or about ALL processes, and what information 
you will see about each. 

Command Files 

ECHO string 

Displays the given string. This command is normally used 

in command files to inform the user of progress. 

EXECUTE command file [ argument . . . ] 

Executes the given command file. The commands in it are 
executed one at a time, just as if you had typed them. Any 
arguments given are passed to the command file, where they 
may be substituted for dummy arguments in the file's 
commands. There are many command file options, and they 
are explained briefly in the AmigaDOS User's Manual. 

FAILAT n 

Stops a command sequence if any program returns an error 
code greater than or equal to the given number. Commands 
indicate that they have failed by sending a positive return 
code. In general, the larger the code returned, the worse the 
failure. This command lets you stop a command sequence 
when an error past a certain severity level has occurred. 

IF [ NOT ] [ WARN I [ ERROR ] [ FAIL ] 

{ strl EQ str | EXISTS file name [ command 

[ ELSE command ] 

ENDIF 
Allows conditional execution of commands in command 
files. You can test to see if two strings, either of which may 
be an argument, are equal, as well as whether a file exists. 
You can also test to see if a warning (return code >= 5), 
error (>=10), or failure (> = 20) occurred. There is an 
optional ELSE clause, and IFs can be nested. 

LAB [ string ] 

Makes the given string a label in the command file. If there 

is no string, this is an unnamed label line. Control flow in 

the command file can jump to labels by using the SKIP 

command. 



QUIT [ n ] 

Stops the command file and sends the specified return code. 

If none is given, the default is zero (i.e., successful 

termination). 

SKIP [ label ] 

Jumps in the command file to the indicated label. If no label 
is given, control jumps to the next (in sequential line order) 
LAB line that contains no string. 

WAIT [ n } [ SEC | SECS | WIN | MlNS | UNTIL time ] 

Causes execution to pause the indicated amount of time or 

until the indicated time. 

Error Management 

FAULT n ( n . . . ] 

Displays the AmigaDOS messages that correspond to the 

specified fault code(s). You may display up to ten messages. 

WHY 

Explains why the previous command failed. Usually, typing 
this immediately after a failed command will give you a more 
detailed explanation of the failure than you first received. 

Developer Commands 

ALINK [ FROM | ROOT ] object file 

I file. . . | + file . . . I 

[ TO output file ] [ WITH file ] 

[ { LIBRARY | LIB } file ] 

[ MAP Hie ] I XREF file ] [ WIDTH n ] 
Links individual object files and libraries together into an 
executable program. The options allow you to control such 
things as the libraries used and where the cross reference 
information is stored. 

ASSEM [ PROG | FROM ] program [ - Oobject file ] 

[ - Vmessage file)[ - Uisting file ) 

[ - Eequates file ] 

[ - Coptions | OPT options ] 

[ -Mnctude directories. . . ] 
Assembles a program written in MC68000 assembly language 
into object code. The options allow you to control such 
things as where the listing and object files go. 

DOWNLOAD [ FROM ] source file [ TO ] destination file 

Allows you to download data from another machine 

(originally, a Sun workstation) to your Amiga. To use it, you 

must have a billboard and the program binload on the source 

machine. 

READ [ TO ) file [ SERIAL ] 

Reads data from either the parallel (default) or the serial 
(with the keyword) port into the specified file. It expects 
pairs of hexadecimal characters, each of which is stored as 
a byte. Input must be terminated with a Q. 

Miscellaneous Commands 



Allows you to add a comment to a command line. The CLI 
will ignore alt characters on the line after the semicolon. It 
may be the first character on the line, i.e., you can have 
comment lines. 

<file 

Redirects the input of a command or program so that it 

comes from the given source (a file or device). 

>flte 

Redirects the output of a command or program so that it 

goes to the given destination (a file or device). 
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AMIGADOS ERROR CODES From the AmigaDOS manual, 2nd Edition 



Code 


Meaning 


Code 


Meaning 


Code 


Meaning 


103 


Insufficient free store 


209 


Packet request type unknown* 


220 


Comment too big 


104 


Task table full 


210 


Invalid stream component name 


221 


Disk full 


120 


Argument line invalid or loo long 


211 


Invalid object lock* 


222 


File is protected from deletion 


121 


File is not an object module 


212 


Object not of required type 


223 


File is protected from writing 


122 


Invalid resident library during load 


213 


Disk not validated 


224 


File is protected from reading 


202 


Object in use 


214 


Disk write-protected 


225 


Not a DOS disk 


203 


Object already exists 


215 


Rename across devices attempted 


226 


No disk in drive 


204 


Directory not found 


216 


Directory not empty 


232 


No more entries in directory* 


205 


Object not found 


218 


Device not mounted 




* = programmer error 


206 


Invalid window 


219 


Seek error* 







AMIGA BASIC ERROR CODES FrmiArrdgaBaskmanuaI,AppendbcB 



Code 


Meaning 


Code 


Meaning 


Code 


Meaning 


1 


NEXT without FOR 


17 


Can't CONTINUE 


53 


File not found 


2 


Syntax error 


18 


Undefined user function 


54 


Bad file mode 


3 


RETURN without QOSUB 


19 


No RESUME 


55 


File already open 


4 


Out of data 


20 


RESUME without error 


57 


Device I/O error 


5 


Illegal function call 


22 


Missing operand 


58 


File already exists 


6 


Overflow 


23 


Line buffer overflow 


61 


Disk full 


7 


Out of memory 


26 


FOR without NEXT 


62 


INPUT past end 


8 


Undefined label 


29 


WHILE without WEND 


63 


Bad record number 


9 


Subscript out of range 


30 


WEND without WHILE 


64 


Bad file name 


10 


Duplicate definition 


35 


Undefined subprogram 


67 


Too many opened files 


11 


Division by zero 


36 


Subprogram already in use 


68 


Device unavailable 


12 


Illegal direct 


37 


Argument count mismatch 


70 


Permission denied (disk write-protected) 


13 


Type mismatch 


36 


Undefined array 


73 


Advanced feature 


14 


Out of heap space 


50 


Field overflow 


74 


Unknown volume 


15 


String too long 


51 


Internal error 


21, 3W9 


, 69, 71-73, 75, 76 78-255 


16 


String formula too complex 


52 


Bad file number 




Unprintable errors 



GURU MEDITATIONS From the file include/exec/alerts.h 

Format of Guru Meditation messages: 



Subsystem ID 


| General Error 


Specific Error 


Address of Task 




CO 


| 00 


I 


0000 


00000000 




Subsystem 


ID Codes 










CPU 


Libraries 




Devices 


Resource 


Other 


CPU Trap* 00 


Exec 


01 


Audio 10 


CIA 20 


Bootstrap 30 




Graphics 


02 


Console 11 


Disk 21 


Workbench 31 




Layers 


03 


GamePort 12 


Misc 22 


DiskCopy 32 




Intuition 


04 


Keyboard 13 








Math 


05 


TrackDisk 14 








Clist 


06 


Timer 15 








DOS 


07 










RAM 


08 










Icon 


09 










Expansion 


0A 









Note: If the first digit of the subsys- 
tem ID is greater than 3, there is no 
way to recover from the error. In 
these cases, subtract 8 from the first 
digit to get the subsystem ID number. 
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General Error Codes 




-00 if not applicable 




Insufficient memory 


01 


MakeLibrary error 


02 


OpenLibrary error 


03 


OpenDevice error 


04 


OpenBesource error 


05 


I/O error 


06 


No signal 


07 



Specific Alert Codes 

Exec Library 

81000001 68000 exception vector checksum 

81000002 ExecBase checksum 

81000003 library checksum error 

81000004 no memory to make library 

81000005 corrupted memory list 

81000006 no memory tor interrupt servers 

81000007 InitAPtr 

81000008 semaphore corrupt 

81000009 free twice 
8100000A bogus exception 

Graphics Library 

82010001 no memory for copper display list 

82010002 no memory for copper instruction list 

82000003 copper list overload 

82000004 copper intermediate list overload 

82010005 no memory lor copper list head 

82010006 long frame, no memory 

82010007 short frame, no memory 

82010008 no memory tor flood fill 

82010009 text, no memory for TmpRas 
8201000A no memory for BltBitMap 
8201000B region memory 
82010030 MakeVPorl 

82011234 GfxNoLCM 



Layers Library 

83010001 LayersNoMem 

Intuition Library 

84000001 unknown gadget type 

04000001 recoverable form of previous message 

84010002 no memory to create port 

84010003 item plane alloc, no memory 

84010004 sub alloc, no memory 

84010005 plane alloc, no memory 
84000006 item box top less than RelZero 

84010007 no memory to open screen 

84010008 open screen, raster alloc, no memory 
84000009 open sys screen, unknown type 
8401 OOOA add SW gadgets, no memory 
8401000B no memory to open window 
8400000C Bad State Return entering Intuition 
84000Q0D Bad Message received by IDCMP 
8400000E Wierd echo causing incomprehension 
8400000F couldn't open the console device 

DOS Library 

07010001 no memory at startup 

07000002 EndTask didn't 

07000003 Qpkt failure 

07000004 Unexpected packet received 

07000005 Freevec failed 

07000006 Disk block sequence error 

07000007 Bitmap corrupt 

07000008 Key already free 

07000009 Invalid checksum 
0700000A Disk Error 
0700000B Key out of range 
0700000C Bad overlay 

RAM Library 

08000001 Bad segment list 

Expansion Library 

OA00OOO1 Bad Expansion Free 



TrackDisk Device 

14000001 calibrate: seek error 

14000002 delay: error on timer wait 

Timer Device 

15000001 bad request 

15000002 bad supply 

Disk Resource 

21000001 get unit: already has disk 

21000002 interrupt: no active unit 

Bootstrap 

30000001 boot code returned an error 

*CPU Traps (exceptions) are defined 
by the 68000 CPU and not by the 

Amiga system software. There are 236 
vectors for CPU exceptions; the lower 
64 are hardware defined, the upper 
192 are user-definable interrupt vec- 
tors. Specific CPU traps you might sec 
in a Guru are: 

00000002 Bus error 

00000003 Address error 

00000004 Illegal instruction 

00000005 Divide-by-zero 

00000006 CHK instruction 

00000007 TRAPV instruction 

00000008 Privilege violation 

00000009 Trace 
0000000A Op Code 1010 
0O00O0OB OpCode 1111 

Other CPU traps include aulovectors 
for different level interrupts, TRAP in- 
struction vectors, and reserved traps. 



Amiga Basic Statements and Functions 

Compiled by William B. Catchings and Mark L. Van Name 

Syntax Conventions and Explanatory Notes 

• Statement and function names and keywords are in capitals. 

• Arguments that you must supply are enclosed in angle brackets, e.g., <x>. 

• Numbers are indicated with single letters, such as <n> or <l>. If the number may be either a real or 
an integer quantity, we use a letter near the end of the alphabet; if it may be only an integer, we use 
<1> or subsequent letters. 

^Strings are denoted with a letter and a dollar sign, e.g., <x$>. 

• Optional arguments are enclosed in square brackets, e.g., [STEP]. 

• If several possible options are available at any point in a command, these are presented within braces 
and separated by vertical bars, e.g., { x | y | z }. Arguments that can repeal are shown in one of two 
ways: with an ellipsis (...) after the argument; or with the notation <arg-list>, which means that there 
can be one or more arguments, each separated from the previous one by a comma. 

These symbols can be intermixed to express different alternatives. For example, the line: 

FUNCTION <x> [ { <y> | [ KEYWORD ] <z> } ] 

says that FUNCTION has one mandatory argument, <x>. It has one additional, optional argument, ei- 
ther <y> or <z>. If you choose <z>, you may optionally precede it with the word KEYWORD. 
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AmigaDOS Statements and Functions 

CHDIR <string> 

DATES 

RLES [ directory of file name> ) 

KILL <(ile> 

NAME <old file name> AS <new file name> 

TIMES 

Control Flow Statements 



<x> K)<y> [ STEP <*> ] 
. . NEXT [ <variabie-lisf> ] 



GOSUE 



FOR <variabte> = 
<statement> 
GOTO <line> 
IF <expression> 
{ GOTO <line> [ ELSE <else clause> ] | 
THEN <then clause> [ ELSE <else ciause> J | 
THEN <statement Wock> 
ELSEIF <expressiort> THEN <stateme(it b)oek> 
ELSE <stalement block> END IFj 
ON BREAK GOSUB { <label> | | 
ON COLLISION GOSUB ( <label> I ) 
ON ERROR GOTO <line> 
ON <expression> GOSUB <line lisl> 
ON <expression> GOTO <line list> 
ON MENU GOSUB { <label> | } 
ON MOUSE GOSUB { <label> | } 
ON TIMER ( ( <n> ) GOSUB ( <label> | 
WHILE <expression> [ <statement> . . . ] 
WEND 

Data Conversion Functions 

CDBL( OO ) 

CHR$( <i> ) 

CINT( <x> ) 

CLNG( <numeric expression> ) 

CSNG( <x> ) 

RX( <x> ) 

HEX$(00) 

MKI$( <short integer expression> ) 

MKL${ <long integer expression> ) 

MKS$( <single precision expressiorO ) 

MKDS( <double precision expression ) 

0CTS<OO) 

STRS(<x>) 

VAL( <x$> ) 

Declarative Statements 

COMMON <variable-tist> 
DATA <constant> . , . 
DEFINT <letter range> 
DEFLNG <letter range> 
DEFSNG <letter range> 
DEFDBL Oetter fange> 
DEFSTR <letter range> 
DIM | SHARED ] <variabJe*l> 

[ ( <dimension-lisO ) ] 
OPTION BASE <i> 
READ <variable list> 
RESTORE [ <line> I 
SHARED <variable Jist> 

Error Handling Statements 

ERR 
ERL 
ERROR <integer expression> 

Function Declaration and Management Statements 

{ CALL <name> ( [ <argument> ... ] ) | 



<name> [ <afgument> ... j } 
CHAIN [ MERGE ] <file> 

[ , | <expression> ] [ , [ ALL ) 
[ , DELETE <range> I ] ] 
DECLARE FUNCTION function id> 

| ( <parameler-li5l> ) 1 LIBRARY 
DEF FN <name> [ ( <parameter-list> ) } 

= <function definition> 
END SUB 
EXIT SUB 
GOSUB <line> 

LIBRARY { <filename> \ CLOSE } 
RETURN ( <!ine> ] 
SUB Subprogram name> 

[ ( <formal parametertisO ) 1STATIC 

Graphics and Intuition 
User Interface Functions 

AREA [ STEP ] ( OO t <y> ) 

AREAFILL [ <mode> ] 

CIRCLE [ STEP ] ( <x>, <y> ) , <fadiffi> 

[ , <cotor id> [ , <start> , <end> 
[ , <aspect> ] ] ] 
CLS 

COLLISION { | <object id> ) } | ON | OFF | STOP } 
COLOR [ foreground color id> ] 

[ , background color id> ] 
CSRUN 
GET ( <x1> , <y1> ) - ( <x2> , <y2> ) 

<array name> [ ( <index list> | ] 
(see also GET under Input/Output Functions) 

LINE [ [ STEP ] ( <x1> , <y1> ) ] 

- [ STEP J { <x2> , <y2> ) , 

[ <color id> ] [ , B [ F J ] 
LOCATE [ <line> ] [ , <co)umn> ] 
MENU { <menu id> , <flem ki> , <state> 
[ , <litle string> J | 

RESET | ( ) | ( 1 ) 1 ON | OFF | STOP } 
MOUSE { ( <i> ) | ON | OFF | STOP ) 
0BJECT.AX <object id> , <value> 
0BJECT.AY <object id> , <value> 
OBJECT.CLIP ( <x1> , <y1> ) - ( <x2> , <y2> ) 
OBJECT.CIDSE [ <object id list> ] 
OBJECT.HIT <object id> , [ <me mask> ] 

[ , <hit masie* ] 
OBJECT.ON <object id list> 
OBJECT.OFF <object id list> 
OBJECT.PLANES <object id> , [ <plane> ] 

[ , <plane switcn> | 
OBJECTPRIORITY <object id> , <priority> 
OBJECT.SHAPE <object id> , 

( <definition> | <obiect2 id> } 
OBJECT.START <object id liat> 
OBJECT.STOP <object id list> 
OBJECT.VX ( <object id> , <value> 1 1 (object id> ) j 
OBJECT. VY ( <object id> , <value> | ( <object id> | )' 
OBJECT.X { <object id> , <value> | ( <object id> ) } 
OBJECT.Y j <object id> , <value> | ( <objec! id> ) }' 
PAINT [ STEP | ( <x> , <y> ) 

[ , <paint color id> [ , <border color id> ] ] 
PALETTE <color id> , <red> , <green> , <blue> 
PATTERN [ <line pattem> ] [ , <area pattenO ] 
POINTf <x> , <y> ) 
POS( <y> ) 

PRESET [ STEP ] ( OO , <y> ) [ , <cotor id> ] 
PSET ( STEP ] ( <x> , <y> ) [ , <color id> ] 
PTAB( OO ) 
PUT [ STEP ] ( <x> , <y> ) , <array> 
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[ ( <index list> ) J [ , ocfion ve*> ) 
(see also PUT under Input/Output Functions) 

SCREEN { <screen id> , <widlh> , <height> 
. <depth> , <mode> | 
ClOSE ecreen id> } 
SCROLL ( <x1> , <y1> ) - ( Oc2> , <y2> ) , 
<pixels to scroll righl> , 
<pixels to scrolt down> 
STICKf <f> ) 
STRIG( <i> ) 
WINDOW { <window id> 

[ , [ <ctlUe> ] 
[,[i<x1>,<yi>)-(<x2>,<y2>)l 

I . [ <type> ] 
( , ecreen id> ] ] ] ] | 
CIDSE <window id> | OUTPUT <vwkJow id> | 
( <i> ) ) 

Input/Output Functions (not graphics or audio) 

CIDSE [ [ « ) <file number> ] . . . 

EOF{ <fle number> ) 

FIELD [ # ] <file number> , <field wid!h> 

AS <string variable> . . . 
GET [ # ] <file number> [ , <record number> ] 
(see also GET under Graphics Functions) 

INKEYS 

INPUT { ; ] [ <prompt string> ; ] Variable list> 
INPUTS ( <x> [ , ( # ] <file numt»f> ] ) 
INPUT* <ftle number> , Variable list> 
LINE INPUT [ ; ] ( " <prompt string> " ; ] 

<string variable> 
LINE INPUTS <file number> ; etring variable> 
10C( <file number> ) 
10F( <fite number> ] 
LPOS(<x>) 
LPRINT { [ expression list> | | 

USING <strir,g 8xpression> ; expression list> 
LSET etring variaole> = etring expression> 
OPEN | <MOOE> , [ # ] <file number> , <file> 

I , <file bufler size> ] | 

<file> | FOR <mode> 1 AS [ # ] <Ble number> 

[ LEN = <file buffer size> ) 
PRINT ( expression ltst> | 

USING <slring expression> ; expression list> 
PRINT* <file number> , 

[ USING <string expression> ; ] 
expression list> 
PUT [ « ] <file number> ( , <record number> 5 
(see also PUT under Graphics Functions) 
RSET <string variable> = <string expression 
TAB{ <i> ) 
WIDTH [ <ogtput device> | JKfile number> | 

LPRINT ] ( <size> | [ , <print area> ] 
WRITE 1 expression !ist> ] 
WRITE* <fiie number> , expression list> 

Mathematical Functions 

ABS(<x>) 
ATN( <x> ) 
C0S( <x> ) 
EXP( <x> ) 
INT( <x> ) 
lDG(<x>) 
SGN( <x> ) 
SIN( <x> ) 
S0R(OO) 
TAN( <x> I 



Memory Access Functions 

PEEKL( <memory address> ) 
PEEK( <memory address> ) 
PEEKW( eiemory atfdress> ) 
POKE <i> , <j> 

POKEL <memory address> , <value> 
POKEWL <memory address> , <value> 
SADDf <string expression> ) 
VARPTR{ <variable name> ) 

Miscellaneous Statements 

LBOUND( <array name> [ , <dimensk>n> ] ) 

I LET ] <variable> = <expression> 

RANDOMIZE { [ expression ] | [ TIMER ] J 

REM <comment> 

RND [ ( <x> ) ) 

SWAP <variab!e1> , <variable2> 

UB0UND( erray name> [ , <dimension> ] ) 

Program Management and Control Statements 

BREAK [ ON | OFF | STOP } 



CLEAR [ , erogram memory> ] [ , 


<stack> ] 


CONT 




DELETE [ <lirve> ] [ - <line> ] 




END 




ERASE <array_vari able-l ist> 




FRE( { -1 | -2| <x> !) 




LIST ( [ <line> ] | 




[ <line> ] [ - [ <line> ] ] , ' 


' <file name> 


LLIST [ <line> ] [ - | <line> | ] 




LOAD ( <flle> [ , R j ] 




MERGE <file> 




NEW 




RESUME [ { | NEXT | <line> ! ] 




RUN [ J <line> | <filename> [ , R ] } 


SAVE [ <file> [ , | A ] P | B ) ] ] 




SLEEP 




STOP 




SYSTEM 




TIMER [[ ON | OFF | STOP } ] 




TflON 




TROFF 





Sound Functions 

BEEP 

SAY " <string> " ( , <mode array> ] 
SOUND { <frequency> , <duration> 

[ , [ <volume> ] [ , <voice> ] ] | 

WAIT I RESUME ) 
<slring variable> = TRANSLATES! " etring> " ) 
WAVE <voice> , <wave definition> 

String Manipulation Functions 

<xj> * <y$> 

ASC( <xS> ) 

INSTR( I <i> , ] <xS> , <y*> ) 

LEFT$( <x$> . <i> ) 

LEN| <x$> ) 

MID$( etring expressions , <i> [ , <|> ] ) 

= etring expression2> 
MID$( <x$> , <i> [ . <j> ] ) 
RIGHTS( <xS> , <i> ) 
SPACES* <x> ) 
SPC( <i> ] 

STRINGSf <length> , { <ascii code> | <x$> } ) 
UCASE$( etring expression> ) 
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Glossary of Amiga Terms 



Compiled by William B. Catchings 
and Mark L. Van Name 



Hardware 

68000: The single-chip microprocessor de- 
signed by Motorola that is used in the 
Amiga, as well as in the Apple Macintosh 
and the Atari ST computer families. 

Bus: The part of a computer's hardware 
that allows the different components to 
exchange data. On the Amiga the bus 
connects the CPU, the memory, the co- 
processors, the disk drives and other 
devices. The Amiga 500 and 1000 have 
external bus expansion slots on the left 
and right sides, respectively. 

Chip Memory: The first 51 2K of memory 
on the Amiga. This memory is accessi- 
ble both by the Amiga's 68000 CPU and 
by its three coprocessor chips. The co- 
processor chips can use only memory 
that falls within this range. 

Coprocessor A separate processor unit 
that assists the main CPU by doing a 
specific task. An example of this is a 
math coprocessor, such as the Motorola 
68881, that handles complex mathe- 
matical computations. The Amiga in- 
cludes a set of three coprocessors that 
assume many audio and video functions 
from the main CPU. 

CPU: (Central Processing Unit) The part 
of a computer that decodes and executes 
the computer's basic instructions. (The 
68000 is the Amiga's CPU.) 

DMA: (Direct Memory Access) A means 
by which different chips in the Amiga 
system use the memory they require by 
writing or reading it directly, as op- 
posed to working with that memory 
through normal CPU instructions. 

Expansion Memory: RAM added to your sys- 
tem beyond its standard configuration. 

Fast Memory: Expansion memory beyond 
the first 512K. It is referred to as "fast" 
because it is not accessible to the Ami- 
ga's coprocessors and therefore does 
not have to be shared by the CPU. 

Kilobyte: 1,024 bytes (two to the tenth 
power). Often thought of as one thou- 
sand bytes and abbreviated by K, as in 
256K (256 times 1024, or approximately 
256,000 bytes). 

Megabyte: Approximately one million 
bytes (1,024 times 1,024 bytes); often 
abbreviated by M or MB. 

Modem: (Modulator/ZVmodulator) A de- 
vice that turns a computer's digital sig- 



nals into a telephone's analog signals 
(modulation), and vice versa (demodu- 
lation). A pair of modems is necessary 
for two computers to commununicate 
over a telephone line. 

Monitor: A video output device similar to 
a television set. 

Mouse: A hand-controlled device that re- 
lates its movement to activities on the 
computer screen such as pointer con- 
trol and program selections. 

Mouse Port: An outlet to which a mouse 
is attached, which can aiso accommo- 
date joysticks and other peripherals. 

Parallel Port: One of the 25-pin outlets on 
the back of the Amiga used primarily 
for connecting with printers. "Parallel" 
indicates that all eight bits of a byte are 
sent simultaneously, on eight separate 
wires within the cable. 

RAM: (Random Access Memory) Storage 
residing on a computer chip, any part of 
which can be read or written in a non-pre- 
defined, or random, order. (This differs, 
for example, from a cassette tape whose 
information is accessed in sequential or- 
der.) This memory is used by the com- 
puter for storing data and executing its 
instructions. 

RJ11: The kind of connector (jack) used 
for modular telephones (and the Amiga 
1000 keyboard). 

ROM: (Read Only Memory) Computer 
storage, similar to RAM, except that it 
can only be read; the computer is not 
capable of writing to ROM memory. 
ROM is often used to store computer 
instructions that don't change (such as 
the Amiga 500's Kickstart code). 

RS-232C: A standard that describes the 
signals used for asynchronous serial 
communications. An RS-232C cable 
would be used to hook the Amiga to a 
Modem or to a serial printer. 

Serial Port: One of the 25-pin outlets on 
the back of the Amiga. This outlet is 
used for asynchronous serial commu- 
nications. Serial indicates that the bytes 
are sent one bit after another. Asyn- 
chronous means that the bytes are sent 
at no specific time, as opposed to syn- 
chronous which sends bytes at pre-de- 
fined intervals. Asynchronous serial 
communications are commonly used 
for connecting computers over tele- 
phone lines and for many printers. 




Software 



AmigaDOS: The Amiga's disk operating 

system. 

AutoConllg: The ability to make hardware 
beyond the standard configuration a 
part of the system automatically. All you 
have to do is connect the hardware; the 
operating system figures out the rest. 
This capability is provided by version 
1.2 of AmigaDOS and is supported by 
most vendors' hardware upgrades, such 
as memory expansion boards. 

Boot: To start a computer. It comes from 
the phrase "to pick yourself up by your 
own bootstraps." This is because the 
computer must first find a program to 
run to tell itself how to run any other 
programs. 

CLI: (Command Line Interpreter) A pro- 
gram that allows the user to execute 
AmigaDOS commands using the key- 
board, as opposed to the Workbench/ 
mouse approach. 

Drawers: Places on the Amiga Workbench 
where you can store programs or files. 
(Drawers are the visual counterparts to 
AmigaDOS directories.) Drawers open 
windows that display their contents. 

Exec: System software composed of 
many routines that perform vital Amiga 
system functions. Exec routines control 
such services as multitasking, interrupt 
and input/output management. 

Gadget: A graphics control device that 
you click on with the mouse to com- 
municate with a program. Examples are 
window scroll gadgets, front/back, close 
and drag gadgets. 

Icon: A graphic image that represents a 
computer object (disk, program or file) 
and with which you can in some ways 
manipulate that object. 

IFF: (Interchange File Format) An Amiga 
software standard (developed primarily 
by Electronic Arts) that allows for the 
interchange of graphic and sound files 
among programs of different type and 
from different companies. IFF supports 
numeric data, dates, pictures, text and 
sound. 

Intuition: The part of the Amiga's oper- 
ating system that provides the graphic 
images that the user sees and uses to 
manipulate the basic system. Intuition 
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is a set of routines that can be used by 
any program running under AmigaDOS 
to display gadgets, menus, requestors 
and icons, and to receive input from 
the keyboard, mouse and other devices. 
By using these routines, different types 
of programs can have consistent user 
interfaces. 

Kickstart: The part of the Amiga's oper- 
ating system that is needed to boot the 
Amiga and run any program. On the 
Amiga 1000, Kickstart is loaded from 
disk into a protected area of RAM 
(called "RAM-ROM"); the Amiga 500 
and 2000 models have Kickstart in hard- 
ware ROM. 

Menu: A graphics "box" usually contain- 
ing selections and usually accessed from 
the menu bar using the mouse. 

Multitasking: The ability of a computer to 
do more than one task at a time; i.e., 
run more than one program at a time. 
Unlike the other popular micros, the 
Amiga's operating system was designed 
to do multitasking. 

OS: (Operating System) The software 
program that is always running on a 
computer. This program manages the 
hardware devices such as the screen and 
the disk drive and allows other pro- 
grams to run. 

Pointer An object, used for making se- 
lections, that moves on the screen as 
you move the mouse. The standard 
Amiga pointer is an arrow. 

Projects: Amiga parlance for things (files) 
created by Tools (programs). Notepad 
notes and DeluxePaint pictures are 
Projects. 

Requester: A rectangular gadget into 
which you must type information be- 
fore continuing in a program. 

Scroll Bar: Scroll bar gadgets allow you to 
see information in a window that is 
outside the current viewing area of the 
window. 

Sizing Gadget: A gadget that allows you to 
resize a window. 

Tools: An Amiga term for a program 
running on the Workbench. The Note- 
pad, Icon Editor and Graphicraft are 

Tools. 

Window: A framed area of the screen that 
can contain an independently-running 
program and is usually manipulatable 
with gadgets. The Amiga's multitasking 
OS allows it to display many windows 
simultaneously. 

Workbench: The Amiga's icon-based user 
software. This part of the OS allows you 
to work with a single graphics interface 



to manipulate files, run programs and 
perform other Amiga functions. Work- 
bench uses the Intuition user inter- 
face routines to supply this graphical 
interaction. 

Audio 

Audio Coprocessor Chip: Nicknamed Paula, 
this chip controls many of the Amiga's 
audio abilities. It handles the actual dig- 
ital-to-analog sound conversion for up 
to four voices within the Amiga. This 
chip also handles many of the input/ 
output tasks for the Amiga, including 
disk and interrupt control, the mouse/ 
joystick ports and the serial port. 

MIDI: (Musical Instrument Digital Inter- 
face) The electronics standard for con- 
necting electronic instruments digitally. 
MIDI is used by synthesizers, rhythm 
machines and other electronic instru- 
ments. The Amiga's audio coprocessor 
has the ability to drive a MIDI interface. 
Though the Amiga does not come with 
built-in MIDI hardware, it can be pur- 
chased relatively inexpensively. 

Voice: Relating to the Amiga: A discrete 
electronically-produced sound. A voice 
can be any tone or instrument sound, 
including percussion sounds. The Ami- 
ga's four-channel sound hardware can 
simultaneously produce four voices, 
two each on the left and right stereo 
channels. 



Graphics/Video 

Animation Coprocessor Chip: Nicknamed Ag- 
nus, this chip controls several important 
graphic functions of the Amiga. It con- 
tains the Blitter and the Copper (see be- 
low), and also controls DMA. 

Bit Map: An area of memory that the 
Amiga treats as a rectangular array of 
pixels. This portion of memory acts as 
the basis of the Amiga's screen graphics. 

Blitter: A part of the animation copro- 
cessor chip that can quickly draw lines 
and manipulate rectangular parts of 
graphic images. The term blitter comes 
from "bit," for BLock Transfer, since it 
moves blocks of bit-mapped data. 

BOB: (Blitter OBject) A graphics ele- 
ment, which can be any size that Fits on 
the screen, that is moved as a unit by 
the blitter. BOBs are not limited in size 
like sprites, but because they are not 
independent of the background, are 
slower to move and require more pro- 
gramming effort to manipulate. 

Copper: A part of the animation coproces- 
sor chip that makes sure that the screen's 
image and the requests of the graphics 



chips stay in synchronization. 

Font: All the characters in a typeface. 
The Amiga's system software has seven 
built-in fonts: its default font is named 
Topaz. 

Genlock: (Amiga Genlock 1300) A device 
that allows the Amiga's graphics to be 
combined and synchronized with those 
from an external video source, such as 
a television or VCR. 

Hold-and-Modlfy: (HAM) A graphics display 
mode in which the Amiga can display 
all possible 4,096 colors on its screen 
at once. 

ILBM: (InterLeaved BitMap) A two-di- 
mensional raster or bit-mapped image, 
with color. ILBM is one of the forms 
supported within the IFF standard; 
therefore pictures stored in ILBM for- 
mat can be transferred from one ap- 
plication to another. 

Interlacing: The method used by the 
Amiga to display 400 horizontal lines 
on the screen: i.e., high resolution 
mode. Interlacing causes the Amiga's 
hi-res flicker noticeable on many mon- 
itors. The standard Amiga display mode 
is non-interlaced, displaying 200 lines 
horizontally. 

Pixels: (From picture elements) The dots 
of light that make up the computer dis- 
play. Screen resolution is given in terms 
of pixels vertically and horizontally, e.g., 
320 x 200 (low res). 

Raster Image: A picture made up of in- 
dividual dots or pixels. This is as op- 
posed to a vector image, which is made 
up from lines. The Amiga produces ras- 
ter images on its monitor. 

Resolution: The number of pixels defined 
vertically and horizontally. The Amiga 
has five bit-mapped resolutions. These 
come from two horizontal resolutions 
(200 and 400) times two vertical reso- 
lutions (320 and 640) plus a special 
Hold-and-Modify mode. 

RGB: (Red-Green-Blue) A term used to 
describe digital and analog color mon- 
itors. RGB digital monitors can display 
16 colors; RGB analog monitors (Amiga 
1080) can theoretically display an un- 
limited number. 

Sprite: A type of graphics element that 
is treated as a unit by the Amiga's spe- 
cial graphics hardware, and tiiat is inde- 
pendent of the background. (The 
Amiga's pointer is a Sprite.) 

Video Coprocessor Chip: Nicknamed Denise, 
this coprocessor assists the 68000 in 
many of the screen control funtions; it 
handles the screen display and supports 
sprites. 
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Amiga Hardware Registers 



Name 



ADD R/W Chip Function 




?* 









iM.CtV> 
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DSKLEN 


• 


024 


w 


P 


DSKDAT 


&' 


026 


w 


P 


REFPTR 


&■ 


028 


w 


A 


VPOSW 




02A 


w 


A 


VHPOSW 




02C 


w 


A 


COPCON 




02E 


w 


A 


SERDAT 




030 


w 


P 


SERPER 




032 


w 


P 


POTGO 




034 


w 
w 


P 


JOYTEST 




036 


D 


STREQU 


&* 


038 


s 


D 


STRVBL 


&' 


03A 


s 
s 


D 


STRHOR 


&• 


03C 


DP 


STRbONG 


&' 


03E 


s 





BLTCONO 


-v 


040 


w 


A 


BLTC0N1 


<\j 


042 


w 


A 


BLTAFWM 


•V 


044 


w 


A 


8UALWM 


-v 


046 


w 
w 


A 


BLTCPTH 


+ "^ 


048 


A 


BLTCPTL 


+~ 


04A 


w 


A 


8LTBPTH 




04C 
04E 


w 


A 


BLTBPTL 


w 


A 


BLTAPTH 


+ -v 


050 


w 


A 


BLTAPTL 


+ ^ 


052 


w 


A 


BLTDPTH 


+ ^ 


054 


w 


A 


BLTDPTL 


+ -V 


056 


w 


A 


BLTSiZE 




058 


w 


A 




05A 








'V 


05C 








'V. 


05E 






BLTCMOD 


<\, 


060 


w 


A 


BLTBMOD 


<v 


062 


w 


A 


BLTAMOD 




064 


w 


A 


BLTDMOD 


066 


w 


A 




<\< 


068 










06A 
06C 














■v 


06E 






BLTCDAT 


wr» 


070 
072 


w 

w 


A 


BLTBDAT 


w\> 


A 


8LTADAT 




074 
076 
078 
07A 
07C 


w 


A 


DSKSYNC 


*v 


07E 


R 


P 


COP1LCH 


+ 


080 


w 


A 



Blitter destination early read (dummy address) 

DMA control (and blitter status) read 

Read vert, most significant bit (and frame flop) 

Read vert, and horiz. position of beam 

Disk data eariy read (dummy address) 

Controller data (vert,, horiz.) 

Controller 1 data (vert., horiz) 

Collision data register (read and clear) 

Audio, disk control register read 

Pot counter pair data (vert., horiz) 

Pot counter pair 1 data (vert., horiz) 

Pot port data read (formerly POTINP) 

Serial data port and status read 

Disk data byte and status read 

Interrupt enable bits read 

Interrupt request bits read 

Disk pointer (high 3 bits) 

Disk pointer (low 15 bits) 

Disk length 

Disk DMA data write 

Refresh pointer 

Write vert, most significant bit (and frame flop) 

Write vert, and horiz. position of beam 

Coprocessor control register (CDANG) 

Serial port data and stop bits write 

Serial port period and control 

Pot port data write and start 

Write to all four controller counters at once 

Strobe for horiz. sync with VB and EQU 

Strobe for horiz. sync with VB (vert, blank) 

Strobe for horiz. sync 

Strobe for identification of long horiz. line 

Blitter control register 

Blitter control register 1 

Blitter first word mask for source A 

Blitter last word mask for source A 

Blitter pointer to source C (high 3 bits) 

Blitter pointer to sauce C (low 15 bits) 

Blitter pointer to souce B (high 3 bits) 

Blitter pointer to souce B (low 15 bits) 

Blitter pointer to source A (high 3 bits) 

Blitter pointer to source A (low 15 bits) 

Blitter pointer to destination D (high 3 bits) 

Blitter pointer to destination D (low 15 bits) 

Blitter start and size (window width, height) 



Blitter modulo for source C 
Blitter modulo for source B 
Blitter modulo for source A 
Blitter modulo for destination D 



Blitter source C data register 
Blitter source B data register 
Blitter source A data register 



Disk sync pattern register for disk read 
Coprocessor first location reg. (high 3 bits) 
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Name 



ADD R/W Chip Function 



Name 



ADD R/W 



C0P1LCL 

C0P2LCH 

C0P2LCL 

C0PJMP1 

C0PJMP2 

COPINS 

DIWSTRT 

DIWSTOP 

DDFSTRT 

DDFSTOP 

DMACON 

CLXCON 

INTENA 

INTREQ 

ADKCON 

AUDOLCH 

AUDOLCL 

AUDQLEN 

AUDOPER 

AUDOVOL 

AUDODAT 



AUD1LCH 
AUD1LCL 
AUD1LEN 
AUDI PER 
AUDI VOL 
AUDI DAT 



AUD2LCH 
AUD2LCL 
AUD2LEN 
AUD2PER 
AUD2V0L 
AUD2DAT 



AUD3LCH 
AUD3LCL 
AUD3LEN 
AUD3PER 
AUD3VOL 
AUD3DAT 



BPL1PTH 

BPL1PTL 
BPL2PTH 
BPL2PTL 
BPL3PTH 
BPL3PTL 
BPL4PTH 
BPL4PTL 
BPL5PTH 
BPL5PTL 
BPL6PTH 
BPL6PTL 



BLPCONO 
BPLC0N1 
BPLCON2 

BPL1M0D 



+ 
+ 



+ 
+ 
+ 

+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 



062 

084 

086 

088 

08A 

08C 

08E 

090 

092 

094 

096 

098 

09A 

09C 

09E 

0A0 

0A2 

0A4 

0A6 

0A8 

0AA 

0AC 

0AE 

0BO 

0B2 

0B4 

0B6 

0BB 

08A 

0BC 

0BE 

0CO 

0C2 

0C4 

0C6 

oce 

OCA 

occ 

OCE 
0D0 
0D2 
0D4 
0D6 
0D8 
ODA 
ODC 
ODE 
OEO 
0E2 
0E4 
0E6 
0E8 
OEA 
OEC 
OEE 
0F0 
0F2 
0F4 
0F6 
0F8 
OFA 
OFC 
OFE 
100 
102 
104 
106 
108 



W 

w 

w 

s 

s 

w 

w 

w 

w 

w 

w 

w 

w 

w 

w 

w 

w 

w 

w 

w 

w 



w 

w 
w 
w 
w 
w 



w 
w 
w 
w 
w 
w 



w 
w 
w 
w 
w 
w 



w 
w 
w 
w 
w 
w 
w 
w 
w 
w 
w 
w 



w 

w 
w 

w 



A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

ADP 

D 

P 

P 

P 

A 

A 

P 

P 

P 

P 



A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 



Coprocessor first location reg. (low 15 bits) 
Coprocessor 2nd location reg. (high 3 bits) 
Coprocessor 2nd location reg. (low 14 bits) 
Coprocessor restart at first location 
Coprocessor restart at second location 
Coprocessor instruction fetch identity 
Display window start (upper left v/h pos.) 
Display window stop (lower right v/h pos.) 
Display bit plane data fetch start (horiz. pos.) 
Display bit plane data fetch stop (horiz. pos.) 
DMA control write (clear or set) 
Collision control 

Interrupt enable bits (clear or set bits) 
interrupt request bits (clear or set bits) 
Audio, disk, UART control 
Audio channel location (high 3 bits) 
Audio channel location (low 15 bits) 
Audio channel length 
Audio channel period 
Audio channel volume 
Audio channel data 



Audio channel 1 location (high 3 bits) 

Audio channel 1 location (low 15 bits) 

Audio channel 1 length 

Audio channel 1 period 

Audio channel 1 volume 

Audio channel 1 data 



Audio channel 2 location (high 3 bits) 
Audio channel 2 location (low 15 bits) 
Audio channel 2 length 
Audio channel 2 period 
Audio channel 2 volume 
Audio channel 2 data 



Audio channel 3 location (high 3 bits) 
Audio channel 3 location (low 15 bits) 
Audio channel 3 length 
Audio channel 3 period 
Audio channel 3 volume 
Audio channel 3 data 



Bit plane 
Bit plane 

Bil plane 
Bit plane 
Bit plane 
Bit plane 
Bit plane 
Bit plane 
Bit plane 
Bit plane 
Bit plane 
Bit plane 



1 pointer (high 3 bits) 

1 pointer (low 15 bits) 

2 pointer (high 3 bits) 

2 pointer (low 15 bits) 

3 pointer (high 3 bits) 

3 pointer (low 15 bits) 

4 pointer (high 3 bits) 

4 pointer (low 15 bits) 

5 pointer (high 3 bits) 

5 pointer (low 15 bits) 

6 pointer (high 3 bits) 
6 pointer (low 15 bits) 



AD 

D 

D 



Bit plane control register (misc. control bits) 
Bit plane control reg. (scroll value PF1, PF2) 
Bit plane control reg. (priority control) 

Bit plane modulo (odd planes) 



BPL2MOD 




10A 

10C 
10E 


W 


A 


BPL1DAT 


& 


110 


W 


D 


BPL2DAT 


& 


112 


w 


D 


BPL3DAT 


& 


114 


w 


D 


BPL4DAT 


& 


116 


w 


D 


BPL5DAT 


& 


118 


w 


D 


BPL6DAT 


& 


11A 
11C 

11E 


w 


D 


SPROPTH 


+ 


120 


w 


A 


SPROPTL 


+ 


122 


w 


A 


SPR1PTH 


+ 


124 


w 


A 


SPR1PTL 


+ 


126 


w 


A 


SPR2PTH 


+ 


128 


w 


A 


SPR2PTL 


+ 


12A 


w 


A 


SPR3PTH 


+ 


12C 


w 


A 


SPR3PTL 


+ 


12E 


w 


A 


SPR4PTH 


+ 


130 


w 


A 


SPR4PTL 


+ 


132 


w 


A 


SPR5PTH 


+ 


134 


w 


A 


SPR5PTL 


+ 


136 


w 


A 


SPR6PTH 


+ 


138 


w 


A 


SPR6PTL 


+ 


13A 


w 


A 


SPR7PTH 


+ 


13C 


w 


A 


SPR7PTL 


+ 


13E 


w 


A 


SPROPOS 


% 


140 


w 


AD 


SPRQCTL 


% 


142 


w 


AD 


SPRODATA 


% 


144 


w 


D 


SPRODATB 


% 


146 


w 


D 


SPR1POS 


% 


148 


w 


AD 


SPR1CTL 


% 


14A 


w 


AD 


SPR1DATA 


% 


14C 


w 


D 


SPR1DATB 


% 


14E 


w 


D 


SPR2POS 


% 


150 


w 


AD 


SPR2CTL 


% 


152 


w 


AD 


SPR2DATA 


% 


154 


w 


D 


SPR2DATB 


% 


156 


w 


D 


SPR3POS 


% 


158 


w 


AD 


SPR3CTL 


% 


15A 


w 


AD 


SPR3DATA 


% 


15C 


w 


D 


SPR3DATB 


% 


15E 


w 


D 


SPR4POS 


% 


160 


w 


AD 


SPR4CTL 


% 


162 


w 


AD 


SPR4DATA 


% 


164 


w 


D 


SPR4DATB 


W 


166 


w 


D 


SPR5POS 


% 


168 


w 


AD 


SPR5CTL 


% 


16A 


w 


AD 


SPR5DATA 


% 


16C 


w 


D 


SPR5DATB 


% 


16E 


w 


D 


SPR6POS 


% 


170 


w 


AD 


SPR6CTL 


% 


172 


w 


AD 


SPR6DATA 


<H> 


174 


w 


D 


SPR6DATB 


% 


176 


w 


D 


SPR7POS 


% 


78 


w 


AD 


SPR7CTL 


% 


17A 


w 


AD 


SPR7DATA 


% 


17C 


w 


D 


SPR7DATB 


% 


17E 


w 


D 


COUOROO 




180 


w 


D 


COIDR01 




182 


w 


D 


COLOR02 




184 


w 


D 


COLOR03 




186 


w 


D 


COLDR04 




188 


w 


D 


COLOR05 




18A 


w 


D 


COUOR06 




18C 


w 


D 


COIOR07 




18E 


w 


D 


COUDRQ8 




190 


w 


D 
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Function 

Bit plane modulo (even planes) 



Bit plane 1 data (parallel-to-serial convert) 
Bit plane 2 data (parallel-to-seria! convert) 
Bit plane 3 data (parallel-to-serial convert) 
Bil plane 4 data (parallel-to-serial convert) 
Bit plane 5 data (parailel-to-seriai convert) 
Bit plane 6 data (parallel-to-serial convert) 



Sprite pointer (high 3 bits) 

Sprite pointer (low 15 bits) 

Sprite 1 pointer (high 3 bits) 

Sprite 1 pointer (low 15 bits) 

Sprite 2 pointer (high 3 bits) 

Sprite 2 pointer (low 15 bits) 

Sprite 3 pointer (high 3 bits) 

Sprite 3 pointer (low 15 bits) 

Sprite 4 pointer (high 3 bits) 

Sprite 4 pointer (low 15 bits) 

Sprite 5 pointer (high 3 bits) 

Sprite 5 pointer (low 15 bits) 

Sprite 6 pointer (high 3 bits) 

Sprite 6 pointer (low 15 bits) 

Sprite 7 pointer (high 3 bits) 

Sprite 7 pointer (low 15 bits) 

Sprite vert.-horiz. start position data 

Sprite vert, stop position and control data 

Sprite image data register A 

Sprite image data register B 

Sprite 1 vert.-horiz. start position data 

Sprite 1 vert, stop position and control data 

Sprite 1 image data register A 

Sprite 1 image data register B 

Sprite 2 vert.-horiz. start position data 

Sprite 2 vert, stop position and control data 

Sprite 2 image data register A 

Sprite 2 image data register B 

Sprite 3 vert.-horiz. start position data 

Sprite 3 vert, stop position and control data 

Sprite 3 image data register A 

Sprite 3 image data register B 

Sprite 4 vert.-horiz. start position data 

Sprite 4 vert, stop position and control data 

Sprite 4 image data register A 

Sprite 4 image data register B 

Sprite 5 vert.-horiz. start position data 

Sprite 5 vert, stop position and control data 

Sprite 5 image data register A 

Sprite 5 image data register B 

Sprite 6 vert.-horiz. start position data 

Sprite 6 vert, stop position and control data 

Sprite 6 image data register A 

Sprite 6 image data register B 

Sprite 7 vert.-horiz. start position data 

Sprite 7 vert, stop position and control data 

Sprite 7 image data register A 

Sprite 7 image data register B 

Color table 00 

Color table 01 

Color table 02 

Color table 03 

Color table 04 

Color table 05 

Color table 06 

Color table 07 

Color table 08 



Name 

COIOR09 

COLOR10 

COLOR11 

COLOR12 

COLOR13 

COLOR14 

COIOR15 

COLDR16 

COL0R17 

COIOR18 

COLOR 19 

COLOR20 

COLOR21 

COLOR22 

COLDR23 

COL0R24 

COLOR25 

COU5R26 

COLOR27 

COIDR28 

COIOR29 

COLDR30 

COLOR31 

RESERVED 

RESERVED 

NOOP(NULL) 



ADD— offset to base chip address SDFF000 

&— register used by DMA channel only 

%— register used by DMA channel usually, processors sometimes 

+ — address register pair. Low word uses DB1-DB15; high word uses OBO-DB2 

'—address not writable by the copper 

^—address not writable by the copper unless COPCON is set true 

A,D,P— Agnus, Denise, Paula 

R,W-Read, Write 

ER— Early read 

S— Strobe 

PTL.PTH-1 8-bit DMA address pointer 

LCULCH-18-bit starting address DMA pointer 

MOD— 15-bit modulo 



ADD 


R/W 


Chip 


Function 


192 


W 


D 


Color table 09 


194 


w 


D 


Color table 10 


196 


w 


D 


Color table 11 


198 


w 


D 


Color table 12 


19A 


w 


D 


Color table 13 


19C 


w 


D 


Color table 14 


19E 


w 


D 


Color table 15 


1A0 


w 


D 


Color table 16 


1A2 


w 


D 


Color table 17 


1A4 


w 


D 


Color table 18 


1A6 


w 


D 


Color table t9 


1A8 


w 


D 


Color table 20 


1AA 


w 


D 


Color table 21 


1AC 


w 


D 


Color table 22 


1AE 


w 


D 


Color table 23 


1B0 


w 


D 


Color table 24 


1B2 


w 


D 


Color table 25 


164 


w 


D 


Color table 26 


1B6 


w 


D 


Color table 27 


1B8 


w 


D 


Color table 28 


1BA 


w 


D 


Color table 29 


1BC 


w 


D 


Color table 30 


1BE 


w 


D 


Color table 31 


1110X 








mix 








1FE 









Registers 


in the Peripheral Interface Adapters (8520s 


i) 




8520-A 


8520-B 


Name 


Explanation 




BFE001 


BFDO00 


PRA 


Peripheral data register A 




BFE101 


BFD100 


PRB 


Peripheral data register B 




BFE201 


BFD200 


DDRA 


Data direction register A 




BFE301 


BFD300 


DDRB 


Data direction register B 




BFE401 


BFD400 


TALO 


TIMER A low register 






BFE501 


BFD500 


TAHI 


TIMER A high register 






BFE601 


BFD600 


TBUD 


TIMER B low register 






BFE701 


BFD700 


TBHI 


TIMER B high register 






BFE801 


BFD800 




Event LSB 






BFE901 


BFD900 




Event 8-15 






BFEA01 


BFDA00 




Event MSB 






BFEBOI 


BFDB00 




No connect 






BFEC01 


BFDC00 


SDR 


Serial data register 






BFED01 


BFDDOO 


ICR 


Interrupt control register 






BFEE01 


BFDEOO 


CRA 


Control register A 






BFEF01 


BFDFOO 


CRB 


Control register B 
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Amiga 500/1000 86 Pin 
Expansion Bus 



Pin function 


Pin 


Func t ion 


Pin 


Function Pin 


Funet i 


in Pin 


Function 


1 


GMD 


19 


/EINT2 


3? 


DOND 


33 


/HUT 


73 


DGND 


2 


GND 


28 


/PALOPE 


38 


A12 


56 


A2B 


74 


/AS 


3 


GND 


21 


A5 


39 


A13 


57 


A22 


75 


PDB 


4 


GND 


22 


/EINT6 


48 


/IPL8 


58 


A21 


76 


PD18 


5 


+5V 


23 


A6 


41 


A14 


59 


A23 


77 


PD1 


6 


♦3V 


24 


A4 


42 


/IFL1 


68 


/BR 


78 


PD9 


7 


N.C. 


25 


DGNB 


43 


A15 


61 


DGHD 


79 


PD2 


8 


-5V 


26 


A3 


44 


/IPLZ 


62 


/BGACX 


88 


PDB 


9 


N.C. 


27 


A2 


55 


Alt 


63 


PD15 


SI 


PD3 


IS 


tIZV 


26 


A? 


46 


/BERR 


64 


/BG 


82 


PD7 


11 


N.C. 


29 


Al 


47 


A17 


65 


PD14 


83 


PD4 


12 


/CONFIG 


30 


A8 


48 


/VPA 


66 


/DTACK 


84 


FD6 


13 


DGND 


31 


FC8 


49 


DGND 


£7 


PD13 


85 


DGND 


M 


/C3 


32 


A9 


sa 


E 


68 


/PRW 


86 


PD5 


15 


CDAC 


33 


FC1 


51 


/VHA 


69 


PD12 






16 


/CI 


34 


Affl 


53 


A1B 


78 


/LDS 






17 


/OVR 


35 


FC2 


33 


/RES 


71 


FD11 






18 


XRDY 


36 


All 


54 


A19 


72 


/UDS 






DIFFERENCES 


BETWEEN AMIGA 2888 CPU SLOT 


AND AMIGA 1B88 


EXPANSION BUS 


9 


Z8MHZ 


28 


N.C. 















Amiga 2000 Zorro 
Expansion Specification 



Parallel 


Ports 




A-ieea 




D-25 n.iln 




Fin Function Pin 


Func t Lon 


1 DRDY* 14 


GND 


2 Data B 13 


GND 


3 Data 1 16 


GND 


4 Data 2 17 


GND 


5 Data 3 18 


GND 


6 Data 4 19 


GND 


7 Data 5 28 


GND 


8 Data 6 21 


GND 


9 Data 7 22 


GND 


18 ACKH 23 


*5v 


11 BUSY<data) 34 


NC 


12 POUT (elk) 35 


RESET* 


13 SEL 




A589/A2ee8 




D-25 ftitale 




Pin Function Pin 


rune t ion 


1 STROBE* 14 


r '.' pullup 


Z Data 8 13 


MC 


3 Data 1 16 


RESET* 


4 Data 2 17 


GND 


5 Data 3 18 


GND 


6 Data 4 19 


GND 


7 Data 5 28 


GND 


8 Data 6 21 


GND 


9 Data 7 22 


GND 


19 ACK* 33 


GND 


11 BUSY 34 


GND 


12 POUT 35 


GND 


13 SEL 





Serial Ports 



Pin 


Function 


Pin 


Funet J 


on 


Pin 


Function 


Pin 


Function 


Pin 


Func tion 






A1BBB 




1 


GND 


21 


AS 




41 


A14 


61 


GND 


81 


BD3 






D-25 


fenal 


e 


z 


GND 


zz 


/ETNT6 


42 


/EINT5 


62 


/BGACK 


82 


BD7 


Pin 


rune r i on 


Pin 


Function 


3 


GND 


23 


A6 




43 


A15 


63 


BD15 


83 


BD4 


1 


GND 




14 


-5Vdc 


4 


GND 


24 


A4 




44 


/EINI4 


64 


/BGM 


84 


BD6 


2 


TkD 




15 


AUDO 


5 


• 5V 


25 


GND 




45 


A16 


65 


BD14 


85 


GND 


3 
4 

5 
6 


RxD 
RTS 
CTS 
DSR 




16 
17 

18 
19 


AUDI 

EB 

INT2« 


6 

7 


t3V 

* 


Z6 

27 


A3 
A2 




46 

47 


/BERR 
A17 


66 

67 


/DTACK 
BD13 


86 
87 


BD5 
GND 




8 


-5V 


28 


A7 




48 


/VPA 


68 


READ 


88 


GND 


7 


GND 




28 


DTR 


9 


/SLAVE K 


29 


Al 




49 


GND 


69 


BD12 


69 


GND 


8 


BCD 




21 


*5Vdc 


18 


tIZV 


38 


A8 




58 


E 


78 


/BLDS 


9B 


GND 


9 







22 





11 


H* 


31 


BFC8 




51 


/VMA 


71 


BD11 


91 


GND 


18 


--- 




23 


+12Vdc 


13 


MM 


32 


A9 




52 


A18 


72 


/BUDS 


92 


7HE 


11 







24 


C2* 


13 


GND 


33 


BFC1 




53 


/RES 


73 


GND 


93 


DOE 


13 







25 


RESBh 


14 


/C3B 


34 


All 




34 


A19 


74 


/BAS 


94 


/RE SB 


13 











15 


CDACB 


35 


BFC2 




55 


/HLT 


75 


BD8 


95 


* /EG IN 












16 


/C1B 


36 


All 




56 


A28 


76 


BD1S 


96 


/EINT1 






A5B8/AZBe8 




17 


/OVR 


37 


GND 




57 


A3 2 


77 


BD1 


97 


RESERVB 






D-35 


f v, ! . 




18 


XRDY 


33 


A12 




58 


A21 


78 


BD9 


98 


RESERV9 


Pin 


Function 


Pin 


Func i i on 


19 


/EINT2 


39 


A13 




59 


A23 


79 


BD2 


99 


GND 


1 
Z 
3 


GND 




14 





28 


tt -12V 


48 


/EINT7 


68 


/BRx 


88 


BD8 


188 


GND 


TkD 

RkD 




15 
16 


— -— 




w = 


/LOCAL-OHN 




= /COHFIG-OUTx 
updated by Ani#a 


ttuti = 


/CONFIG-IN 


H 




4 
5 
6 


RTS 
CTS 
DSR 




17 
IB 

19 


AUDI 




DIFFERENCES BETWEEN ORIGINAL ZORRO SFECIFICATIOI" 


AND AMIGA 


2888 


SLOTS 


7 
S 
9 


GND 
DCD 
♦12v 




28 
21 

22 


DTR 


19 


/INTZ 


21 


/INT6 




42 


/IFI.l 






92 


7H 


RI 






48 


/IPL8 




44 


/IPL2 






96 


RESERV7 


ie 
11 

12 
13 


-12v 
AUDO 




23 
24 
25 


— 





Memory Map 
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288888 



A888BB — 

BFDBBB — 
C888B8 — 

DFF888 — 

Eeaeae — 

EB8BBB — 

F8BB8B — 

F6BBBB — 
FFFFFF — 



512K Chip Menem 
Reserued 

8 Megabyte 
Heiwry Spaae Fop 
Auto-Configuration 
Expansion Devices 

Reserved 

I/O For 8528' s 

CPU RAH 

Ci'T.'nn Chip Addresses 

Reserved 

Auto-Confiffurat ion 
Expansion Decoding 
Reserved 

ROM 



A2000 System Block Diagram* 

A 1000 lacks 100-pin expansion circuitry 

A500 has some expansion RAM on the same side of the bus as the chip RAM 
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* Courtesy Commodore Business Machines 



ASCII Chart 



Decimal 


ASCII 


HEX 


Binary 


Decimal 


asch 


HEX 


Binary 


Decimal 


ASCII 


HEX Binary 





NUL 


00 


00000000 


29 


GS 


1D 


00011101 


58 




3A 


00111010 


1 


SOH 


01 


00000001 


30 


RS 


1E 


00011110 


59 




3B 


00111011 


2 


STX 


02 


ooooooio 


31 


US 


1F 


00011111 


60 


< 


3C 


00111100 


3 


ETX 


03 


00000011 


32 


SP 


20 


00100000 


61 


= 


3D 


00111101 


4 


EOT 


04 


00000100 


33 


! 


21 


00100001 


62 


> 


3E 


00111110 


5 


ENQ 


05 


00000101 


34 


" 


22 


00100010 


63 


? 


3F 


00111111 


6 


ACK 


06 


00000110 


35 


n 


23 


00100011 


64 


@ 


40 


01000000 


7 


BEL 


07 


00000111 


36 


$ 


24 


00100100 


65 


A 


41 


01000001 


8 


BS 


08 


00001000 


37 


% 


25 


00100101 


66 


B 


42 


01000010 


9 


HT 


09 


00001001 


38 


& 


26 


00100110 


67 


C 


43 


01000011 


10 


LF 


0A 


00001010 


39 


■ 


27 


00100111 


68 


D 


44 


01000100 


11 


vr 


0B 


00001011 


40 


( 


28 


00101000 


69 


E 


45 


01000101 


12 


FF 


oc 


00001100 


41 


) 


29 


00101001 


70 


F 


46 


01000110 


13 


CR 


0D 


00001101 


42 


• 


2A 


00101010 


71 


G 


47 


01000111 


14 


SO 


0E 


00001110 


43 


+ 


2B 


00101011 


72 


H 


48 


01001000 


15 


S! 


OF 


00001111 


44 


, 


2C 


00101100 


73 


I 


49 


01001001 


16 


DLE 


10 


00010000 


45 


- 


2D 


00101101 


74 


J 


4A 


01001010 


17 


DC1 


11 


00010001 


46 




2E 


00101110 


75 


K 


4B 


01001011 


18 


DC2 


12 


00010010 


47 


/ 


2F 


00101111 


76 


L 


4C 


01001100 


19 


DC3 


13 


00010011 


48 





30 


00110000 


77 


M 


4D 


01001101 


20 


DC4 


14 


00010100 


49 


1 


31 


00110001 


78 


N 


4E 


01001110 


21 


NAK 


15 


00010101 


50 


2 


32 


00110010 


79 


O 


4F 


01001111 


22 


SYN 


16 


00010110 


51 


3 


33 


00110011 


80 


P 


50 


01010000 


23 


ETB 


17 


00010111 


52 


4 


34 


00110100 


61 


O 


51 


01010001 


24 


CAN 


18 


00011000 


53 


5 


35 


00110101 


82 


R 


52 


01010010 


25 


EM 


19 


00011001 


54 


6 


36 


00110110 


83 


S 


S3 


01010011 


26 


SUB 


1A 


00011010 


55 


7 


37 


00110111 


84 


T 


54 


01010100 


27 


ESC 


1B 


00011011 


56 


8 


38 


00111000 


85 


U 


55 


01010101 


26 


FS 


1C 


00011100 


57 


9 


39 


00111001 


86 


V 


56 


01010110 
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87 


w 


57 


01010111 


102 


f 


66 


01100110 


117 


u 


75 


01110101 


88 


X 


58 


01011000 


103 


9 


67 


01100111 


118 


V 


76 


01110110 


69 


Y 


59 


01011001 


104 


h 


68 


01101000 


119 


w 


77 


01110111 


90 


Z 


5A 


01011010 


105 


i 


69 


01101001 


120 


X 


78 


01111000 


91 


[ 


58 


01011011 


106 


J 


6A 


01101010 


121 


y 


79 


01111001 


92 


\ 


5C 


01011100 


107 


k 


6B 


01101011 


122 


z 


7A 


01111010 


93 


] 


50 


01011101 


108 


I 


6C 


01101100 


123 


{ 


7B 


01111011 


94 


A 


5E 


01011110 


109 


m 


60 


01101101 


124 


I 


7C 


01111100 


95 




SF ' 


01011111 


110 


n 


6E 


01101110 


125 


} 


7D 


01111101 


96 


' 


60 


01100000 


111 





6F 


01101111 


126 


"u 


7E 


01111110 


97 


a 


61 


01100001 


112 


P 


70 


01110000 


127 


DEL 


7F 


01111111 


96 


b 


62 


01100010 


113 


q 


71 


01110001 










99 


c 


63 


01100011 


114 


r 


72 


01110010 










100 


d 


64 


01100100 


115 


s 


73 


01110011 










101 


e 


65 


01100101 


116 


t 


74 


01110100 











Printer Device Command Functions* 





Gmd 


Escape 






Cmd 


Escape ' 




Name 


No. 


Sequence 


Function 


Name 

3FNT2 


No. 

36 


Sequence 

ESC(K 


Function 


aRIS 





ESCc 


reset 


German char set 


aRI,N 


1 


ESC#1 


initialize 


aFNT3 


37 


ESC(A 


UK char set 


aIND 


2 


ESCD 


If 


aFNT4 


38 


ESC(E 


Danish I char set 


aNEL 


3 


ESCE 


return.lf 


aFNTS 


39 


ESC(H 


Swedish char set 


aRI 


4 


ESCM 


reverse If 


aFNTS 


40 


ESC(Y 


Italian char set 


aSGRO 


5 


ESC[0m 


normal char set 


aFNT7 


41 


ESC(Z 


Spanish char sat 


aSGR3 


6 


ESC[3m 


italics on 


aFNT8 


42 


ESC(J 


Japanese char set 


aSGR23 


7 


ESC[23m 


italics oft 


aFNT9 


43 


ESC(6 


Norwegian char set 


aSGR4 


8 


ESC[4m 


underline on 


aFNT10 


44 


Esqc 


Danish II char set 


aSGR24 


9 


ESC[24m 


underline off 


aPR0P2 


45 


ESC[2p 


proportional on 


aSGR1 


10 


ESC[1m 


boldface on 


aPROPI 


46 


ESC[1p 


proportional off 


aSGR22 


11 


ESC[22m 


boldface off 


aPROPO 


47 


ESC[0p 


proportional clear 


aSFC 


12 


ESC[nm 


set foreground color where n stands 


aTSS 


48 


ESC[n E 


set proportional offset 








for a pair of ASCII digits, 3 followed 


aJFYS 


49 


ESQ5F 


auto left justify 








by any number 0-9 


aJFY7 


50 


ESC[7 F 


auto right justify 


aSBC 


13 


ESCfnm 


set background color where n stands 


aJFY6 


51 


ESC[6F 


auto full justify 








for a pair ol ASCII digits, 4 followed 


aJFYO 


52 


ESC[0F 


auto justify off 








by any number 0-9 


aJFY3 


53 


ESC[3 F 


letter space (justify) 


aSHORPO 


14 


ESC[0w 


normal pitch 


aJFYI 


54 


ESC[1 F 


word fill (auto center) 


aSHORP2 


15 


ESC[2w 


elite on 


aVERPO 


55 


ESC[0z 


1/8" line spacing 


aSHORPI 


16 


ESC[1w 


elite off 


aVERPI 


56 


Esqiz 


1/6" line spacing 


8SHORP4 


17 


ESC[4w 


condensed fine on 


aSLPP 


57 


ESC[nt 


set form length n 


aSHORPS 


18 


ESC[3w 


condensed off 


sPERF 


58 


ESCfnq 


perf skip n (nTO) 


aSH0RP6 


19 


ESC[6w 


enlarged on 


aPERFO 


59 


ESC[0q 


pert skip off 


aSHORPS 


20 


ESC[5w 


enlarged off 


aLMS 


60 


ESC#9 


Left margin set 


aDEN6 


21 


ESC[6"z 


shadow print on 


aRMS 


61 


ESC#0 


Right margin set 


aDEN5 


22 


ESC[5"z 


shadow print off 


aTMS 


62 


ESC#8 


Top margin set 


aDEN4 


23 


ESC[4"z 


doublestrike on 


aBMS 


63 


ESC#2 


Bottom margin set 


aDEN3 


24 


ESC[3"z 


doublestrike off 


aSTBM 


64 


ESC[n;nr 


T&B margins 


aDEN2 


25 


ESC[2"z 


NLQon 


aSLRM 


65 


ESC[n;ns 


L&R margin 


aDEN1 


26 


ESC[1"z 


NLQoff 


aCAM 


66 


ESC#3 


Clear margins 


aSUS2 


27 


ESC{2v 


superscript on 


aHTS 


67 


ESCH 


Set Horiz tab 


aSUS1 


28 


ESC[1v 


superscript off 


aVTS 


68 


ESCJ 


Set vertical tabs 


aSUS4 


29 


ESC[4v 


subscript on 


aTBCO 


69 


ESC[0g 


Clr horz tab 


aSUS3 


30 


ESC[3v 


subscript off 


aTBC3 


70 


ESC[3g 


Clear all h tab 


aSUSO 


31 


ESC[0v 


normalize the line 


aTBCl 


71 


ESC[1g 


Clr vertical tabs 


aPUU 


32 


ESCL 


partial line up 


aTBC4 


72 


ESC[4g 


Clr all v tabs 


aPLO 


33 


ESCK 


partial line down 


aTBCALL 


73 


ESC#4 


Clr all h & v tabs 


aFNTO 


34 


ESQB 


US char set 


aTBSALL 


74 


ESC#5 


Set default tabs 


aFNT1 


35 


ESqR 


French char set 


aEXTEND 


75 


ESC[n"x 


Extended commands 



n stands for adedma! number expressed as a set of ASCII digits, for example 12. 
The escape codes for use in Amiga Basic are in column 3. 

• Table reprinted by permission of Addison-Wesley Publishing Company, Inc., Reading, MA 01867 from AMIGA ROM KERNEL REFERENCE MANUAL: 
LIBRARIES AND DEVICES © copyright 1986 by Commodore Electronics, Ltd. Publication date August 1986. 
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Now AmigaWbrld puts 
a powerful new research too] 
♦ right at your fingertips* 



If you need instant access to news and information 
about your competition, your profession, technology, 
finance, law, or just about any other subject, 
Amiga World's SearchLink will give it to you. 

igaWorld's new SearchLink service 
l you easy access to more than 
itabases in just minutes! 

AndSearchLink gets you answers to all sorts of 
questioris'frorn these databases -like details about new 
products and services, or market facts, or emerging 
technologies. You can get information on computers, 
medicine, investments, law, chemistry, engineering 
^and much more* Everything from accounting to 
ademarks to history or geography, 

earchLink is easy to use and inexpensive. 



AUyou need is a credit card and a computer 
with modem. 

NtfSfcscriptions. No passwords. No difficult 
manuals to learn. Just call 800-843-7337 with your 
computerHid log on. You pay only $7.99 per search 
(a few databases carry surcharges) plus 25 cents per 
minute fortelecommunications and $2 for each ab- 
stract you want to see. (You can also get hard copies). 
Youcan charge everything to MasterCard, VISA, or 
American Express. 

SearcHlink provides 24'hour 
on-line assistance. 



^KarchLink even gives you free on-line tips 
from trained SearchLink search specialists if you have 

;rc>blems or questions about your searching. Just type 
SOS" when you're on-line! 

SearchLink gets you to the information 
you want. 



If you've ever wanted to access databases 
offered by ADP Network Services; BRS; Data-Star; 
Datasolve; DataTimes; Dialog; G-Cam Serveur; 
NewsNet; PergamonlnfoLine; SDC; Questel; or 



VU/TEXT, SearchLink will access databases from ; 
of them— without a special subscription or knowledge! 
of special search languages. 



We can't list all of SearchLink's more than 800 databases, 
but just to give you an idea, here are some of the databases 
available under the topic "COMPUTER." 

Business Software 

Database 
COMPENDEX* 



Computer Database 

COMPUTERPAT 

INSPEC 



Menu— The International 
Software Database 

Microcomputer Index 

Online Microcomputer 
Software 

SUPERTECH 



And here are just a few of the other popular databases you 


can access with SearchLink. 




ABI/INFORM 


ERIC 


Chemical Abstracts 


PTS PROMT 


Disclosure 


TRINET 


(Selected databases) 


Trademarkscan 


Donnelley Demographics 


Standard and Poor's 


Dun & Bradstreet 


Corporate Descriptions 


(Selected databases) 





Call 800-843-7337 now! 



Put the power of knowledge to work for you 
right now. Call 800-843-7337 (THE-SEER) on your 
computer and get the answers you need to stay ahead. 

*A complete list of the databases is available on SearchLink. 

SEARCHLINK 

From AmigaWorld 

Your link to the world of information. 

An International Data Group Service 

SearchLink is sponsored hy the National 1-Yderalioii ol 

Abstracting aad Informal ion Services. 

NFAIS is a professional association of database producers. 




ACWCI Tublicaiion 

An International Data Group Company 



For mure information about SearchLink BY VOICE, dial 617-879-0700. 



TRUE BASIC LANGUAGE SYSTEM 



Turn your 

Amiga 

into a 

flying machined 




Speed, great graphics and 
enough built-in power to let 
you really fly: that's what you 
expect from your Amiga®. 
And that's what you get from 
programming in True 
BASIC. 

It's a structured language 
that's easy to use. A compiler, 
editor and debugging tools 
rolled into one. It's the latest 
from Kemeny and Kurtz, the 
inventors of BASIC. 



If you crunch 
numbers, you'll 
appreciate floating- 
point math that's 
very fast. Support for 
large, dynamic 
arrays, and built-in 
syntax for matrix 
algebra. 



And True BASIC 
makes graphics even 
easier. Define your 
own coordinate schemes and 
color palettes. Plot entire 
arrays with a single 
statement. Apply built-in 2D 
transforms. Or use the 3D 
Graphics Library to put some 
depth in the picture. 



With the Developer's Toolkit 
you can launch sprites and 
bobs. Add pull-down menus, 
and get at all the Intuition and 
Kernal features. But if 
portable code is important, 
there's True BASIC for the PC, 
Macintosh™ and Atari* ST as 
well. 

As your programs get bigger, 
you'll want to build your own 
external libraries. 



LANGUAGE 


COMPILER/DEBUGGER 


• multi-line functions 


• compiles to fast, compact 


•SELECT CASE, IF/ELSE IF 


b-code 


■ local, global variables 


• separately-compiled libraries 


• recursion 


• parameter type-checking 


■GKS graphics 


• set breakpoints and continue 




• immediate mode execution 


LIMITS 




• strings to 1 megabyte each 


EDITOR 


• floating-point 5e-309 to 1 ,8e+308 


■ full-screen, mouse-based editor 


• unlimited program size. 


■ global search, replace 


arrays, data 


• block copy, move, delete 


■ names up to 31 characters 


• menu, function key, command 


• auto memory management 


line interfaces all supported 



They can be separately 
compiled, in BASIC, C or 
assembly. Debug with 
breakpoints and immediate 
mode. Create keyboard 
macros to complement True 
BASIC'S fantastic editor. 



But if you're just learning 
how to fly, True BASIC will 
coach you with on- line 
HELP. Friendly error 
messages, and a tutorial- 
based User's Guide. 

Find out why thousands of 
engineers, developers, and 
students use True BASIC for 
their flights of fancy. Visit 
your Amiga dealer, or call 
us today at 1-800-TRBASIC. 



Language System $99.95 
Runtime Package $99.95 

Developer's Toolkit, 
3-D Graphics Library, 
Sorting & Searching, 
Advanced String Library 
$49.95 

each 



Amiga ts a registered trademark of 
Commodore- Amiga ■ — Macintosh is licensed 
to Apple Computer — Atari is a registered 
trademark of Atari Corp — True BASIC is a 
trademark of True BASIC, Inc. 



inc. 




39 South Main Street 
Hanover, NH 03755 
(603)643-3882 



Circle 333 on Reader Service card. 



Arrivals and Departures: 

Input, Output and C 

Learn to access printers, disk drives and other peripherals from your C programs. 



I 



By Vincent M. Hopson 

n C programming, input from and output to anything 
other than the keyboard and screen (using print/ or 
scan/) can be very confusing. Moreover, any errors in 
the specification of parameters to input/output (I/O) 
subroutines can cause the Amiga to warm start or hang 
without apparent cause. This article covers the basic 
aspects of I/O from C, and presents three similar pro- 
grams to illustrate different methods of disk I/O. 

When accessing a file in Amiga Basic, you use an 
OPEN statement to request a data stream, and supply a 
number to identify it. C uses the same concept, except 
the system supplies the file identifier and the open 
statement has three variations on the Amiga: /open, 
when you want to use high-level file pointers (fp); open 
for using low-level file descriptors (fd); and Open, for 
using AmigaDOS file handles (fh). Both C and BASIC 
require that you further restrict access to the data 
stream by declaring a direction — read or write. 
AmigaDOS file-handle data streams are opened without 
a direction and are assumed to be both read and write. 

I/O with AmigaDOS file handles (Open) is similar to 
using I/O with generic C file descriptors (open). The 
AmigaDOS function names begin with a capital letter 
to differentiate them from equivalent C subroutines. 

Amiga Basic manipulates data streams by using 
PRINT* or INPUT# commands. The programmer sup- 
plies the number that identifies the desired stream. C 
allows the programmer more flexibility in the control 
of data flow. Some of the available data stream com- 
mands are /put (put a character), /puis (put a string) and 
/print/ (print a formatted string). Many C programs use 
print/ and scan/ for console I/O and the file pointer vari- 
ations, /print/ and /scan/ for disk I/O. Another version of 
these same commands uses a string (an array of charac- 
ters) as the destination of their activity: sprint/ and 
sscanf. The string is then applied to the I/O data stream 
using puts or similar functions. 



Closing the data stream before the program exits is 
generally required in BASIC, but C file pointers have 
no such restriction. When a C program exits, all of the 
file pointer data streams arc closed automatically. How- 
ever, C will not deallocate other resources such as file 
descriptors or file handles; therefore, it is good practice 
to make your own arrangements for closing files and 
returning resources. 

A facet of I/O on the Amiga not to be covered in 
depth here is the system interface. Be aware, however, 
that many of these calls return useful information 
about files, such as creation or modification dates and 
file size. 

Pointers, Descriptors and Handles 

File pointers, descriptors and handles are the values 
that are returned when you open a file, depending 
upon the I/O method you choose. The values are 
required by the data stream handling functions in C. 

Generally, file pointers are used with text-only files. If 
an executable file (one that contains values from 0x00 
to OxFF) is manipulated via file pointers rather than 
using /read or/write, NULLs present a problem. Since all 
strings are delimited with NULLs, this character cannot I 
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File pointers, 
descriptors and 
handles are the 
values that are 
returned when you 
open a file, 
depending upon the 
I/O method you 
choose. 



iippcar inside a file pointer source or return buffer 
(string) as a valid character. To compound this problem, 
some of the file pointer I/O subroutines convert line- 
feeds into NULLs. Within these restrictions, file point- 
ers are very powerful, since formatted printing or input 
can be done directly from the data stream instead of 
from a string buffer. 

What you lose in flexibility with file pointers is 
regained with file descriptors and handles. All routines 
using these methods of I/O must buffer the input or 
output in a string and use string-manipulative routines 
to get the data to or from the data stream. Descriptors 
and handles are not as sensitive to the contents of the 
data stream as pointers, and may be used on any file. 
All of the routines that use them require the descriptor 
or handle, a buffer and the number of characters to get 
or put. If the routine returns a - 1, an error has 
occurred. Any other number is the number of charac- 
ters that were actually transferred. A zero indicates 
EOF (end of file). 

File handles point to AmigaDOS I/O structures, 
instead of acting as indices of I/O control blocks as file 
descriptors do. Handles and descriptors are used alike, 
except handle routines have the first letter capitalized 
and the file handle Open returns a NULL to represent 
failure instead of - 1. All of the file descriptor and file 
handle routines with similar names have similar returns 
and functions. Take care to use file handles with rou- 
tines that have capitalized names and file descriptors 
with uncapitalized routine names. Placing the wrong 
parameter in an I/O call can be catastrophic. 

New C users should note that all of the routines that 
work with file pointers use file descriptors or handles 
to actually accomplish their task. This point is illus- 
trated by the existence of a level two I/O call thai 
returns the file descriptor associated with the file 
pointer data stream. This allows you to open a file with 
a pointer, acquire the descriptor associated with the 
same file and manipulate the stream with descriptor 
calls. 

Descriptors and handles represent the lowest 
level — level one — of generic C I/O. Pointers represent 
level two I/O; subroutines that use pointers actually call 
routines on the next lower level (descriptors and han- 
dles) to perform their function. Called the layered 
approach, this technique is used frequently in large sys- 
tems, such as the UNIX operating system. Each addi- 
tional layer, or level, in a system requires you to know 
less and less about the specific implementation of the 
command you have executed. A layer, in general, 
should be less complicated than the layer beneath il 
and more complex than the one above. Generally, using 
high-level functions is easier than using low-level ones; 
it is also less efficient. 

Keyboard interaction is a good example of the lay- 
ered approach. A programmer executes a .scan/ com- 
mand to obtain information for his program. A level 
two command, scattf uses the information in the subrou- 
tine call to request, via a level one command, a buffer 
full of data from the keyboard. The level one command 
calls a subroutine that actually manipulates the key- 



board hardware interface to acquire characters until 
the user presses Return and the buffer is ready. The 
level one routine then terminates the buffer with a 
NULL and returns to level two. The scanf routine then 
processes the data into I tic chunks requested by the 
programmer in the control string and returns to (he 
calling program. The programmer never needs to know 
how the keyboard processing system works, but is able 
to acquire data from it, which is why the layered 
approach is so useful. 

AmigaDOS Devices 

Nine devices exist under AmigaDOS: DFO:, RAM:, PRT:, 
PAR:, SER:, CON:, RAW:, * and NIL:. DFO: is the 
inboard disk drive driver; external drives lake the 
names DFL, DF2:, etc. RAM: is the RAMdisk device. 
PRT: is the generic printer driver, PAR: and SER: are 
the parallel and serial port drivers and CON: is the 
console driver. RAW: is a device thai may be used to 
access keyboard input or console output without any 
translation of keystrokes by the CON: driver. The cur- 
rent window is *. NIL: is the proverbial bit bucket — 
anything sent to it will be dumped mercilessly into 
space. 

You can access all of these devices with any version 
of the open command you wish to use. If your system- 
configuration file in the devs: directory is properly 
updated with Preferences, opening PRT: will access 
your printer whether it is on the serial or parallel port. 
The PRT: driver converts general Amiga function codes 
to the ones specifically for your printer. Available func- 
tion codes for PRT: are outlined in the Technical Refer- 
ence Guide included in this issue. 

Opening some of these devices may require addi- 
tional information. File names may be specified as 
D¥0:directory/file or "RAM-directory /file. CON: and RAW: 
opens must be declared as: 

CON -xpos/yposfwidlh/lxeigh 1/til le 
RJWxposfypos/width/height/tMe 

Xpos and ypos specify where the window will appear. 
Width and height specify its size and title is the name 
at the lillebar. 

Easy as 1, 2, 3. . ■ 

Listing I is a program that uses file pointers to read a 
file from the disk and print it to the generic printer 
device, PRT:. Notice that opening a device is the same 
as opening a file; C considers all data streams as files. 
The first line of the generated printout contains the file 
name, followed by data from the file. This program is 
relatively simple and easy to expand upon. 

Several checks are made lo ensure the validity of the 
print request. A check of the argument count will deter- 
mine if the user has input a file name. If no file name 
is present, a simple warning message is sent to the con- 
sole and the program exits. A non-zero exit value alerts 
the calling program that an error has occurred and that 
normal processing should be suspended. The value of 
the return may also be used to classify the failure, and 
suggest cleanup or recovery work. 
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The program then tries to open a data stream to the 
printer, then to the requested file. If either attempt 
returns a NULL, the open was unsuccessful, and the 
program exits with an error code. Failure to open the 
printer reports the error only, whereas a failure to 
open the file for input must report the error and close 
the successfully opened printer data stream. 

The fprinlf statement sends a form feed to the 
printer, followed by Filename: and the name that was 
specified in the command line. Notice that the first 
parameter is the file pointer, followed by the control 
string and any parameters to convert. 

Three file pointers arc automatically opened when 
you execute a C program, stdin (standard input), sldout 
(standard output) and stderr (standard error output). 
The keyboard is usually stdin; sldout and stderr are typi- 
cally the console. The priMf command you use to print 
to the screen is just a specialized case of fprintf; it uses 
the console by default. Therefore the statement 
printffTest Statement); is functionally equivalent to 
fprintffsldout, Test Statement);. This also holds true for 
scanf and fscanf, except you'd of course substitute stdin 
for stdout. For error messages, use stderr to ensure that 
redirection from the command line will not cause the 
error message to disappear into some other file stream. 
I left this out of the examples to preserve simplicity. 

The while loop gets lines from the input file with the 
/gets command. A siieof argument provides the length of 
the buffer. You are (hen able to change the size of the 
buffer in the declaration at the top of the program 
without having to change the length parameter there. 
When thefts subroutine returns a NULL all of the 
characters from the file have been processed and an 
EOF condition exists. If you want, rewind will return to 
(he top of the input file, and Iseek returns to any byte in 
the file. 

As long asfgets does not return a NULL, /puts sends 
the obtained data to the printer. This process continues 
until an EOF condition occurs to terminate the while 
statement. Both pointers are then closed, and the pro- 
gram ends. 

There are more error conditions here than I have 
checked for. If the printer driver encounters some 
error, this routine will hang and not return. Unless you 
play with the on-line button randomly, or disconnect 
the printer, this condition is unlikely. You can either 
flag the situation as a problem in the documentation, 
or place an error check in the while loop. Whenever 
using I/O streams, it is good practice to plan for the 
unexpected and check all returns for validity. There are 
exceptions, however. If an error causes the Amiga to 
restart and you cannot prevent it, don't bother to check 
for that error. Since no recovery is possible, the error- 
checking code would probably never be executed. 

Descriptors and File Handles 

Listing 2 is the same program, using descriptors. The 
major differences are in the descriptor declarations and 
the inclusion of a character count variable. File descrip- 
tors are declared as integers, since they are indices into 
an array of I/O blocks. 



A file called fcntl.h is also included to define the 
symbols 0_RDONLY and 0_WRONLY. These symbols 
are used to declare the direction of the I/O data stream; 
just as r and w were in the (open statements of the pre- 
vious example. AmigaDOS file handle Opens use MODE 
OLDFILE and MODF_NEWFILF. definitions without 
regard to direction. These definitions may be found in 
libraries/dos.h. 

The number of characters input by the read state- 
ment is stored in count. A tally is maintained to tell the 
write statement how much of the buffer is real data. 
Without this information, it is possible to print parts of 
the input buffer that are invalid. Both the printer file 
stream and file data stream are closed as the program 
exits. 

Listing 3 is an example using file bandies. File han- 
dles follow the conventions of pointers during opening, 
anil descriptors in their use. 

These three programs represent variations on a sim- 
ple printing routine. The routine is prone to error, but 
does illustrate the use of C I/O. File pointers, handles 
and descriptors may be used together as well. For exam- 
ple, a file pointer could open the text data file 10 he 
printed and a file descriptor or handle could send data 
to the printer. This configuration is useful if you decide 
to take complete control of the output device and han- 
dle the special printer function codes yourself. 

Programs and Signals 

Finally, the signals CTRL-C, CTRL-D, CTRL-E and 
CTRL-F affect certain flags while a program is execut- 
ing. The significance of this is not apparent until a 
command goes berserk and you wish to stop ii without 
restarting the machine. If an application program 
periodically checks its signals, it is possible to cause the 
program to take some alternate action (such as termi- 
nating normally) by using signal flags. After a little 
experimentation. I found that the CTRL-C through 
CTRL-F flags were bits 12, 13, 14 and 15 of the signal 
longword stored in the task control block. All programs 
receive these signals whenever the CTRL-letter combi- 
nation is used. 

Listing 4 illustrates this in a template form. A Find- 
Task call without a name parameter will return a 
pointer to this task's control block. The appropriate sig- 
nal flags are checked by performing a logical AND 
comparison of the longword with a mask of signals that 
you wish to check for. If the signal is present, the result 
will be non-zero. AmigaDOS never clears these signals; 
you must do this yourself if a signal may occur more 
than once (i.e., if a signal doesn't terminate the pro- 
gram). Signal masks are defined in the include file 
libraries/dos.h and appear as SIGBREAKF'_CTRLx. 
Sec the Libraries and Devices reference manual page 
D-170 lines 154 to 157. 

This article is intended to get you started using C 
iiiput/oiipul. Tiir AmigaDOS Mimuid. Second Tditum by 
Commodore-Amiga is a helpful reference for some of 
the finer points of I/O in C on the Amiga. However, the 
best way to learn about I/O is to actually write some 
code and test it. The worst hazard of a program gone ►■ 



Whenever using I/O 
streams, it is good 
practice to plan for 
the unexpected and 
check all returns 
for validity. There 
are exceptions, 
however. 
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bananas is an Amiga warm-start or the printer spewing 
bizarre patterns on a few sheets of paper. With so little 
to lose and so much to gain, experiment! ■ 

Vincent Hopson works as a software engineer for Spectrum 
Digital in Herndon, VA. Write to him c/o AmigaWorld 
editorial. 



Listing 1. File pointer example. 

* 

* FILE POINTER EXAMPLE 



* This program will take the first argument from 

* the command line as a filename, and print it. 

//include "lattice/stdio.h" 

/* 

* Error return codes. 
*l 

i do fine tNSUTFICIENT_AKGS I 

fdefine NO_PR INTER 2 

(/define BADJT I.ENAME 3 

* « 

* Main E n L r y Point 

* * 

main(argc, argv) 
int argc; 
char *argv[ ] ; 

( 

char buffer[ 160]; /* temporary storage buffer */ 
FILE *fp; /• pointer into file stream */ 
FILE *pfp; /* pointer to printer stream */ 

/* 

* See if enough parameters are on the command line by 

* checking the number of parameters entered. 
*/ 

if (arge < 2) 
I 
/* 

* Not enough arguments. Remind him of the usage, 

* and exit with appropriate return. 
*/ 

printf ("Usage: print <f i lename>\n") ; 
exit(INSUFFIClENT_ARGS) ; 
} 

/* 

* Enough arguments are there. Attempt to open the 

* printer data stream as a write stream. 

*/ 

pfp = fopenC'PRT:", "w"); 
if (pfp == NULL) 
[ 
/* 

* Couldn't do it for some reason. Tell the user, 

* and return error code. 
*/ 

printf ("Cannot open printer data stream. \n"}; 
exit (NO PRINTER); 



/* 



] 



* The printer is ready. Attempt to open the specified 

* file on the command line. 

*/ 

fp = fopen(argv[l], "r"); 
if (f p == NULL) 



/* 

* Cannot open the file. Close the printer data 

• stream, alert the user, and return code. 
*/ 

printf ("Cannot open file data stream: %s\n",argv[ 1 ] ) ; 
fclose(pf p) ; 
exit(BAD FILENAME); 



Send a formfeed, and filename banner. 



fprinlf(pfp, "\fFilename: %s\!i\n", argv[l]); 

/* 

* Loop here in the "while" construct. Fill the 

* buffer with fgets, and dump i t to the printer 

* with fputs. Continue to loop here until NULL 

* characters are gotten (EOF). 
*/ 

while (fgets(buffer, sizeof (buffer) , fp) != NULL) 
: [jiii s( but ti-i . ;■' p ) : 

/* 

* Return all resources before exit. 
*/ 

fclose(pf p) ; 
fclose( f p) ; 



Listing 2. File descriptor example. 

* * 

* FILE DESCRIPTOR EXAMPLE 
* 

* This file performs the same task as the previous 

* example, and is commented where they differ. 
# 

/* 

* "fcntl.h" contains definitions for 0_RIX)N!.Y, and 

* 0_WR0NLY. 

^include "lattice/stdio.h" 
/(include "lattice/fcntl.h" 



/(define INSUFFICIENT_ARGS 1 
//define NOJ'R INTER 2 

#define BAD_FILENAME 3 

main(argc, argv) 
int argc; 
char *argv[ ] ; 

( 

char buffer! 160]; 

int fd; /* input file descriptor */ 

int pfd; /* printer file descriptor */ 

int count; /* character count for buffer */ 

if (argc < 2) 

[ 

printf ("Usage: print <f ilename>\n'M ; 

exit(INSU!-TICIENT_ARGS) ; 
} 

/* 

* Notice that the open contains 0_WR0NLY instead of 

* "w", and that a bad return is not zero, but -1. 
*/ 

pfd - openC'PRT:", 0_WR0NLY); 
if (pfd == -1) 

( 

printf ("Cannot open printer data stream. \n"); 



Listing continued on p. 72 
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from p. 10 

exit(NO_PRIKTER); 
! 

/* 

* Here, too, notice that the open contains 0_RDONLY 

* instead of "r". 
*/ 

fd = open(argv[l], 0_RDONLY); 
if (fd == -1) 

{ 

printf ("Cannot open file data stream: %s\n", argv[]]); 

dose(pfd) ; 

exit (BAD FILENAME); 



/* 

* Major differences occur when using file descriptors 

* and pointers. The string that we wish to place at 

* the top of the generated listing must be "sprintf'ed 

* into a buffer, then written to the data stream with 

* a "write" command. The stolen command inside of the 

* write invocation will compute the size of the string 

* to be printed, since the filename may vary in size. 
*/ 

sprintf(buf fer, "\fFilename: %s\n\n", argv[l]); 
write(pfd, buffer, stclenfbuf fer) ) ; 



/* 
* 
* 
* 
* 
* 

* 
# 

* 

*/ 
whi 



"count" stores the number of characters that were 
moved in the read command. This tells us the number 
of valid characters in the buffer. A sizeof statement 
is used to send the size of the buffer. If, in the 
future we wish to change the size of "buffer", the 
change will be reflected here without having to come 
to this statement to change anything. 



I assume that the "write" command works properly. An 
error check should be placed there. 

le ((count a read{fd, buffer, sizeof (buffer))) > 0) 
write(pfd, buffer, count); 



close(pfd) ; 
ciose( fd) ; 



Listing 3. File handle example. 



* * 

* FILE HANDLE EXAMPLE * 

/* 

* "dos.h" is included to define "MODE_xxxFILE" , and 

* define the FileHandle structure. 
*/ 

^include "libraries/dos.h" 
/(include "lattice/stdio.h" 

//define 1NSUFFTCIENT_ARGS 1 
//define NO_PRINTER 2 

//define BAD_FILENAME 3 



This definition will cause the compiler to handle 

* returns from the AmigaDOS "Open" statement properly, 

* and return the proper object. 
*/ 

extern struct FileHandle *0pen(); 

main(argc, argv) 
int argc; 
char *argv[ ] ; 



char buffer[160]; 
struct FileHandle *fh; 
struct FileHandle *pfh; 
int count; 

if (urge < 2) 



/* input file handle */ 
/* printer file handle */ 



printf ("Usage: print <f iiename>\n") ; 
exit(TNSUFFICIENT_ARGS) ; 



( 

) 

/* 

* Here the open statement is capitalized, and the 

* stream is declared as an existing filo. If a new 

* file was to be created, M0DE_0LDFILE would be changed 

* to MODE_NEWFILE. 

* Notice also that an error condition is a NULL, not -1 . 
»/ 

pfh = OpenC'PRT:", MODEJOLDFILE) ; 
if (pfh == NULL) 



I 



printf ("Cannot open printer data stream. \n"); 
exit (NO PRINTER); 



! 



fh = Open(argv[l], M0DE_0LDFILE) ; 
if (fh == NULL) 

{ 

printf ("Cannot open file data stream: %s\n", argv[ 1 
close(pfh) ; 
exit(BAD FILENAME); 



/* 

* Basically, the only difference here is that the 

* operation commands "Write", and "Read" have the first 

* letter capitalized. 
*/ 

sprintf(buf fer , "\fFilename: %s\n\n", argv[l]); 
Write(pfh, buffer, stclen(buf fer) ) ; 

while ((count = Read(fh, buffer, sizeof( buffer))) > 0) 
Writefpfh, buffer, count); 

Close(ofh) ; 
Close(fh); 



Listing 4. Sigyiat use program template. 
SIGNAL USE PROGRAM TEMPLATE 

^include "exec/types. h" 
^include "exec/tasks. h" 
/■include "libraries/dos.h" 

extern struct Task *FindTask{ ); 



main( ) 

( 



struct Task *taskcb; 

... Other declarations, and program initialization 

taskcb ■ FindTaskC "); 

... and to periodically check the flags ... 

if (tcb->tc_SigRecvd & (flags you wish to check)) 

... code to execute when signal arrives ... 

} 
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AVAILABLE NOW! 

StarBoairJ2 

If you've owned your 
Amiga® for a while now, you 
know you definitely need 
more than 512k of memory. 
You probably need at least 
double that amount... but you 
might need as much as an 
additional two megabytes . 
We want to urge you to use 
StarBoard2 as the solution 
to your memory expansion 
problem -and to some of 
your other Amiga-expansion 
needs as well! 
It's small, but ifs BIG- 

Since most of you want to expand your 
Amiga's memory without having to also 
expand your computer table, we designed 
StarBoard2 and its two optional 
"daughterboards" to fit into a sleek, 
unobtrusive Amiga-styled case that snugly 
fastens to your computer with two precision- 
machined jackscrews. 

The sculpted steel case of StarBoard2 
measures only 1. 6" wide by 4.3" high by 
10.2'*long. You can access the inside of the 
case by removing just two small screws on the 
bottom and pulling it apart. We make 
Star Boa rd2 easy to get into so that you or 
your dealer can expand it by installing up to 
one megabyte of RAM on the standard 
StarBoard2 or up to two megabytes by 
adding in an Upper Deck. 

This card has decks! 

The basic StarBoard2 starts out as a one 
megabyte memory space with Ok, 512k, or 
one megabyte installed. If you add in an 
optional Upper Deck (which plugs onto the 
Main Board inside the case) you bring 
StarBoard2 up to its full two megabyte 
potential. You can buy your StarBoard2 
with the Upper Deck (populated or 
unpopulated) or buy the Upper Deck later as 
your need for memory grows. 

And you can add other functions to 
StarBoard2 by plugging in its second 
optional deck -the Multifunction Module! 

St a r Boa rd2 : fu net ions f ive ! 

If we count Fast Memory as one function, 
the addition of the MultiFunction Module 
brings the total up to five! 
THE CLOCK FUNCTION: 

Whenever you boot your Amiga you have 
to tell it what time it is! Add a MultiFunction 
Module to your StarBoard2 and you can 
hand that tedious task to the battery-backed, 




Auto-Configuring 

Fast RAM 

Zero Wait States 

User Expandable 

from 51 2k to 

2 Megabytes 

Bus Pass- Through 

MultiFunction 

Option: battery/ 

clock, FPU, 

parity, Sticky-Disk 



real-time clock/calendar. A small piece of 
MicroBolics software in your WorkBench 
Startup-Sequence reads the clock and 
automatically sets the time and date in your 
Amiga. And the battery is included (we 
designed it to use an inexpensive, standard 
AAA battery which will last at least two 
years before needing replacement). 
THE FLOATING POINT FUNCTION: 

If any one aspect most characterizes the 
Amiga it's fast graphics! Most graphic 
routines make heavy use of the Amiga 
Floating Point Library. Replacing this library 
with the one we give you with your 
MultiFunction Module and installing a 
separately purchased Motorola 68881 FPU 
chip in the socket provided by the Module 
will speed up these math operations from 5 to 
40 times! And if you write your own software, 
you can directly address this chip for 
increased speed in integer arithmetic 
operations in addition to floating point math. 
THE PARITY CHECKING FUNCTION: 

If you install an additional ninth RAM 
chip for every eight in your StarBoard2, 
then you can enable parity checking. Parity 
checking will alert you (with a bus-error 
message) in the event of any data corruption 
in StarBoard2's memory space. So what 
good is it to know that your data's messed up 
if the hardware can't fix it for you? It will 
warn you against saving that data to disk and 
possibly destroying your database or your 
massive spreadsheet. The more memory you 
have in your system the more likely it is, 
statistically, that random errors will occur. 
Parity checking gives you some protection 
from this threat to your data residing in Fast 
RAM. Note that the Amiga's "chip" RAM 
cannot be parity checked. 
THE IMMORTAL MEMORY DISK 
FUNCTION (STICKY-DISK): 

When you've got a lot of RAM, you can 
make nice big RAM-Disks and speed up your 
Amiga's operations a lot! But there's one bad 
thing about RAM-Disks: they go away when 
you re-boot your machine. Sticky-Disk solves 
that problem for you. It turns all of the 
memory space inside a single StarBoard2 
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into a Memory Disk that will survive a 
warm-reboot! When your Amiga attempts to 
grab a StarBoard2 in Sticky-Disk mode, a 
hardware signal prevents the system from 
acquiring the StarBoard2 as FastRAM (and 
thereby erasing your files) -instead it is re- 
recognized as a Memory Disk and its contents 
are preserved intact. If you want to work 
rapidly with large files of data that are being 
constantly updated (such as when developing 
software) you can appreciate the Sticky-Disk! 

Fast RAM -no waiting! 

StarBoard2 is a totally engineered 
product. It is a ZERO WAIT-STATE design, 
auto-configuring under AmigaDOS 1 .2 as 
Fast RAM. Since AmigaDOS 1.1 doesn't 
support autoconfiguration, we also give you 
the software to configure memory in 1.1. 

Any applications software which "looks" 
for Fast RAM will "find" StarBoard2. And 
you'll find that your applications run more 
efficiently due to StarBoard2 on the bus. 

A passing bus? Indeed ! 

What good is an Expansion Bus if it hits a 
dead end, as with some memory cards? Not 
much, we think -that's why we carefully and 
compatibly passed through the bus so you 
could attach other devices onto your Amiga 
(including another Star Board 2, of course!). 

The sum of the parts... 

A really nice feature of the StarBoard2 
system is that you can buy exactly what you 
need now without closing off your options for 
future exapansion. You can even buy a Ok 
StarBoard2 (with a one megabyte capacity) 
and populate it with your own RAM 
(commonly available 256k by I by 150ns 
memory chips). When you add StarBoard2 
to your Amiga you have a powerful hardware 
combination, superior to any single-user 
micro on the market. See your Authorized 
Amiga Dealer today and ask for Sl:irItoard2 

SUGGESTED RETAIL PRICING: 
StarBoard2. Ok (1 meg space): 
SiarBoard2. Ok (2 meg space): 
StarBoard2, 512k (1 meg space}: 
StarBoard2, 1 meg (1 meg space) 
SlarBoard2, 2 megs installed: 
StarBoard2, 2 megs & MultiFunction: 
Upper Deck. Ok (1 meg space): 
MultiFunction Module: 
also available: 

Standard 255k memory card: 
MASDrive20, 20 meg harddisk 
MouseTime, mouseport clock: 



$349 
S395 
S495 
S595 
$879 
$959 
$ 99 
$ 99 



$129 

$1495 

$ 50 



Circle 325 on Reader Service card. 



Where Things 
Get Done: 

An Overview of the Workbench 

The Amiga 's graphic interface lets you perform 
miracles with your mouse. No experience necessary. 



w 



By Vinoy Laughner 

orkbench is the Amiga's distinctive graphics system of 
menus, windows and icons. It was designed appropri- 
ately for the Amiga's multitasking environment since it 
lets you visually keep charge of and control a number 
of things that arc happening "simultaneously" and 
places a wide range of decisions and activities within 
your easy grasp. Sometimes the CI. I is more direct, but 
Workbench, because of its non-linear, visual approach, 
can make complex operations as simple as 
1 . . . 2 . . . clicks of the mouse, that is. Being no lover of 
programming and no willing initiate into DOS myster- 
ies, when 1 go to work on (he Amiga, I usually go first 
to Workbench. 

This article is a user's introduction and overview of 
Workbench. It is intended to be a compact, overall ref- 
erence; for more detail, refer to your Introduction to 
Amiga manual and the manual addition that comes with 
the version 1.2 Enhancer. This article presupposes that 
you have the version 1 .2 upgrade: if you don't, it 
should be your next purchase. And make at least one 
backup copy of your Workbench disk for safe keeping 
(Kickstart and Extras also), because "things" can hap- 
pen, and do. 

Workbench Terminology 

Certain objects and activities have special names in 
Workbench and are used throughout this article. They 
are quite easy to grasp and remember. Once they are 
understood, following through a process will be much 
simpler. Here's a short list: 

Click: This means to press down a mouse button. 

Double-click: This refers to clicking twice with the left 
mouse button. This is the usual method of opening 
Workbench windows and of activating programs by 
their icons. 

Select: This means to click once on something with the 
left mouse button. Once selected, objects are ready to 
have some operation performed on them. 



Highlighted: When objects (such as icons) have been 
selected, ihey change color, or are highlighted. 

Drag: This means to select something (such as an 
icon or window) and while continuing to hold the left 
mouse button down, moving it to a different location. 

Gadget: This refers lo any box or thing upon which 
you are required to click the mouse to perform some 
operation, make a selection or yes/no-type decision. 

Requester: These are gadgets in which you must type 
something in order to proceed with some operation. 

Took: These are programs that perform some useful 
function; the Notepad, Icon Editor, Diskcopy program 
and Calculator are tools. 

Getting Around in Workbench 

Mouse, Icons, Windows, Drawers 
The right mouse button is for making selections from 
menus; the left mouse button is for moving and activat- 
ing things, such as moving, selecting or activating icons, 
or moving a cursor. Keyboard equivalents for these 
functions are as follows: left-AI.T + left-Amiga key = 
left mouse button; right-ALT + right-Amiga key = 
right mouse button. To move the pointer by keyboard, 
use either Amiga key and the four arrow keys. Doing 
this while holding down Shift will cause the pointer to 
move a greater distance. ► 
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Dressing Up Your Workbench: 
Using the Icon Editor 



AREN'T YOU TIRED of clicking on those same little 
boxey drawers, when you could have light bulbs, rocket 
ships, ice cream cones or dinosaurs adorning your 
Workbench? Or how about little treasure chests that 
open when you click on them? The Icon Editor tool is a 
mini graphics program for redrawing all the icons that 
appear on the Workbench. It's easy to use, and a clever 
way to dress up and personalize your Workbench 
display. 

The IconMerge program that comes on the 1.2 Extras 
disk is used along with the Icon Editor to produce 
icons that change shape or image when selected. (Two 
icons are actually "merged" into one, so that when you 
select the icon, the alter image appears; e.g., the Icon- 
Merge icon.) I suggest you move IconMerge to the Sys- 
tem drawer with IconEd. The results to using these 
programs are strictly aesthetic, but it might make using 
Workbench a lot more fun! 

Loading and saving icons are the only functions you 
are likely to have trouble with in the Icon Editor. This 
is because the requesters that you type into for the 
Load and Save options in the Disk menu require that 
you refer to icons in AmigaDOS form. (A little knowl- 
edge of CLI typing format will help a lot here.) It's not 
difficult if you remember where the icons are that you 
want to change, and what type they are. 

Everything In Its Place 

The five types of icons are: Disk, Drawer, Tool, Project 
and Garbage, which you probably have seen on the 
Icon Editor's confusing intro screen. Disk and Trashcan 
icons represent unique drawers and therefore arc 
unique icons. Disk icons are always referred to as DISK, 
no matter what the disk's name is. Since in AmigaDOS 
the internal drive is DFO: and the external drive is 
DEL, to load or save the internal disk's icon, you type 
DF0:DISK. Type DFLDISK for loading or saving the 
external disk's icon. The Trashcan icon is referred to 
by name; of course this can vary depending on if you 
have renamed it. The Trashcan icon is, however, in its 
own category, and this is important when it comes to 
saving it, as described below. 

Drawer icons are referred to by name. If the icon is, 
for example, the System drawer in the Workbench win- 
dow in the internal drive, you would type 
DFOiSYSTEM. If it were an icon for a drawer you 
named TURKEYS on the disk in the external drive, you 
would type DF1 TURKEYS. If an icon is within a 
drawer that is within another drawer, such as the Note- 
pad icon in the Utilities drawer in the Workbench 
drawer in the external drive, you must type 
DF1 UTILITIES/NOTEPAD. The slash tells the Amiga 



that the last typed name refers to an icon that is within 
the drawer named before the slash; no spaces are 
used — unless, of course, the icon name has spaces (a 
practice I don't recommend). 

To confuse ihings, you can substitute a slash for DFO:, 
but not for DF1:. (An initial slash always refers to the 
system disk, or Workbench disk, which must be booted 
in the internal drive.) Therefore, you can type /SYS- 
TEM/SAY to load or save the Say program icon in the 
System drawer on the Workbench disk in the internal 
drive. Just remember, an icon has to be referred to 
properly to be saved or loaded; the program won't load 
an icon if you do this wrong, but it will save things to 
places you don't want it to, and this can cause you a lot 
of grief. 

From There and Back Again 

Saving icons has a further condition, which points up 
the significance of recognizing icon types: Icons can 
only be saved from frames that had icons of the same 
type loaded into them. Strange but true. Therefore, a 
frame used to load a drawer icon can only be used for 
saving drawer icons; a frame used for loading tool 
icons (like the Notepad's) can only be used for saving 
tool icons, Project file icons (like textfile icons) must be 
saved from frames where Project files were loaded. The 
Trashcan can only be saved from a window it was 
loaded into; likewise for disk icons. This can become 
very confusing if you load icons into the nine available 
different frames and move them around, or erase, copy 
or merge them into other frames; especially since each 
time you enter an icon's name to load it, you erase the 
previously loaded icon's name from the requester. The 
one fail-safe method I have found for keeping this 
straight is to always save an icon from the same frame 
you first loaded it into. This is worth being careful 
about (write it down): Saving icons improperly can 
scramble things up in your Workbench; you will seri- 
ously regret it if you manage to separate an icon from 
its program, take my word for it! Again, always use a 
copy of an original disk. 

One Plus One Equals One 

The IconMerge tool that comes on the 1.2 Extras disk is 
used with the Icon Editor for creating icons that change 
metamorphically when you click on them. It actually 
merges two icons so that the second icon appears when 
the icon is selected. It is quite easy to use and the 
results are great fun. 

Using IconMerge is simple if you remember the 
rules. Let's say you want to create a drawer icon that is 
a box that opens when you click on it. First, you load 
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the drawer icon and redraw it in its frame as the 
"before" icon — the closed box — and then save it to its 
proper place. Now you create the "after" icon, the open 
box. The most important things to remember about 
saving the "after" icon are that it must be saved in 
exactly the same sized box as the "before" icon, and 
you must name it something different than the "before" 
icon. You will have noticed that you have an option 
when saving icons: You can save them as entire frames 
or as boxed portions of the frame with the Frame and 
Save feature. If you (as I always do) box icons the size 
you want, you will have to make sure you save the 
"after" icon the same size. If you don't do this, the icon 
when selected will shift. An easy way to ensure this is to 
save things as whole frames, but this can be a waste of 
space. I usually put "register" marks in the frame to 
indicate the size frame I will save, being careful to put 
them outside of the area I want to save. This is easy if 
you put the marks on the "before" frame before saving 
it and then duplicate the frame and modify the copy 
for your "after" icon. 

Once you have your "after" icon ready, save it to the 
same drawer (or type location) as its "before" icon by a 
name other than the name of the final merged icon; 
e.g., you could save it as TURKEYS. 2 if the"before" 
icon is TURKEYS. Now leave the Icon Editor and acti- 
vate IconMerge. Follow the simple directions: Type the 
name of the first icon, let's say TURKEYS, and hit 
return; type the name of the second icon, TURKEYS. 2, 
return; then type the name of the final icon you want, 
TURKEYS. When you press return, the program will 
merge the icons. Now, close and reopen the drawer 
containing your merged icons (or, if it's a disk icon, 
reboot). You will find a loose copy of the "after" icon, 
which you can discard or store somewhere, if you want 
to use it again. If you change the merged icon with the 
Icon Editor, you will lose the "after" icon and will have 
to merge icons again; a good reason to store those 
loose icons away in a separate drawer. Many funny, 
descriptive and clever variations are possible with this 
feature. My Workbench contains doors that open, faces 
that change, a skinny cat that grows fat (the Expansion 
drawer) and other bizarre and humorous icons; I'm a 
confessed doodler at heart. 

Icons Away 

Although it takes some trial and error, the Icon Editor 
is one of the more creatively-oriented tools on the 
Workbench, especially when combined with IconMerge. 
Experiment, use your imagination, and you will be 
pleased with the results these sophisticated little tools 
have to offer.D 



Icons represent disks and the drawers, programs and 
files on them. Double-clicking activates them and they 
can be dragged around, even between windows (exclud- 
ing disk icons) representing different disks. Multiple 
icons can be dragged at the same time by holding down 
Shift while you select any number of icons (they will all 
appear highlighted), and without releasing the mouse 
button after selecting the last icon, dragging it; all the 
selected icons will move in a group. 

Drawers have icons that when activated open win- 
dows. Drawers make it possible to group and store 
things of a simitar nature together. Therefore, tools 
related to disks and the Amiga system come in the Sys- 
tem drawer; the Notepad and Calculator — utility pro- 
gram tools — are in the Utilities drawer. When you place 
an icon within a window, you have actually placed the 
program that icon represents within the directory rep- 
resented by that window. Drawers can be put within 
drawers within drawers, etc.; this is equivalent to direc- 
tories with subdirectories with sub-subdirectories. 
Though it can provide insight into the way the Amiga 
handles things, you never need to understand the direc- 
tory structure drawers represent to use them from 
Workbench. Although disk icons and the Trashcan icon 
are considered as representing drawers, they have some 
different properties, e.g., they cannot be placed within 
other drawers or deleted. 

Windows in Workbench display what is in a drawer 
or provide the frames within which some programs 
run. You can easily manipulate a window by using that 
window's gadgets. To move a window, click the Left 
mouse button on the stripped bar at the window's top, 
and drag the window where you want it. Windows are 
sized by dragging the gadget at a window's bottom 
right. At the top right of windows are their back-front 
gadgets: By clicking on these, you place that window 
behind all others displayed on the screen at that time, 
or bring it to the front. This allows multiple windows to 
be open at once and displayed, as it were, in layers; you 
will find you often have to move and size windows to 
get at a particular window's front-back gadgets to bring 
it to the front. A gadget at the top left closes the win- 
dow. Some windows have Scroll Bar gadgets, which 
allow you to visually scroll the contents of the drawer 
into view, vertically and horizontally. Disk windows 
have "fuel" gauges on the left side to tell you how 
full — or empty — the disk is. 

When you click in a window, that window becomes 
active; only one window is active for input at a time, 
although numerous windows can be actively displaying 
program output simultaneously (multitasking). You will 
see this especially when a number of windows are 
opened and you need to move among them to work; 
when you move to a different window, you have to click 
within that window with the left mouse button first, 
before you can work in it. If a window has a menu bar 
associated with it, it will be displayed when that window 
is active and you press the right mouse button. 

Moving Things 

If you want to move something from one place to^- 
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A good way to 
make new empty 
drawers is to 
duplicate the Empty 
drawer and 
rename it, . . 



another in Workbench, simply drag the thing to be 
moved to its new location. If you want to move a pro- 
gram from one drawer to another, you need not open 
the drawer's window you are moving it to; you can sim- 
ply drag the icon over the drawer icon itself. If you 
move something from a drawer on one disk to a drawer 
on another disk, a copy will be made to place on the 
destination disk; the original will remain on the disk 
vou dragged the icon from. Disks can be copied in this 
way also. (See below under Disk Operations.) 

The Workbench Menu Bar 

At the top of die Workbench screen is the menu bar. 
To make menu selections, you use the right mouse but- 
ton and move the pointer to the menu title. When the 
menu opens, and with the button still held down, move 
the pointer to the desired selection, which will become 
highlighted; when you release the mouse button, the 
selection is made. If your menu selection opens a sub- 
menu, continue into that menu to the desired selection. 
If a menu selection appears in a ghost form (spotted 
and will not highlight), it indicates that the selection is 
unavailable for use with whatever you are currently 
doing. The menu bar itself displays the available free 
RAM memory (e.g., if it says 29016, you have about 29K 
of free RAM). You will notice this number rise and fall 
as you open and close things in the Workbench; it will 
give you a good indication of how much memory a par- 
ticular thing uses. 

The Workbench menu bar has three menus: Work- 
bench, Dish and Special. Below are brief descriptions of 
all the options contained in these menus. 

Workbench Menu Options 

Open adds an optional way of opening windows, draw- 
ers and programs, instead of double-clicking on an 
icon. Simply select an icon and then choose Open. 
Close does the same as the close gadgets at the top-left 
of windows, except it only works for certain windows; 
try it to find out. 

Duplicate is for duplicating disks, drawers, programs 
or files. (Duplicating disks is explained in the section 
below on Disk Operations.) To duplicate drawers, tools 
and files, simply select the appropriate icon and then 
select Duplicate. Drawers will be duplicated and, there- 
fore, everything inside them too. A copy will be made 
and named "Copy 2 of. . .," or "Copy 3 of. . .," or 
whatever the number duplicate it is. A good way to 
make new empty drawers is to duplicate the Empty 
drawer and rename it whatever you want. Rename is 
for changing the names of disks, drawers and pro- 
grams. To do this, select the icon of what you want to 
rename and choose Rename; a requester will appear 
into which you type the new name. When you have 
typed the new name, press return and the name with 
the icon will change. (You can't use a / (slash) or a colon 
in names since these are conventions used by the Ami- 
ga's operating system.) It is also advisable to avoid 
spaces in names, and, as you will find when icons get 
crowded, to avoid long names. Many people use con- 



ventions, such as suffixes like .txt or Plist, to aid in 

easily differentiating things of different type, like text 
files and program listings. 

Do not Rename the System drawer or the Expansion 
drawer. These drawers are default drawers for specific 
programs and changing their names will cause the 
Amiga to fail to locate some important programs. The 
Diskcopy and Initialize programs reside in the System 
drawer; the Amiga automatically looks there for them 
and they must stay there (don't move their icons from 
the System drawer window). Likewise, the expansion 
drawer is where "driver" programs are stored that are 
necessary for using hard-disk drives; the Amiga will 
look there for them (if you use a hard disk) and won't 
find them if the drawer is Renamed. If you Rename the 
Utilities drawer, you will have to change the default 
location of the Notepad (since the Amiga will look for 
it there). 

Info will give you information about a disk, drawer 
or program if you choose it after selecting an icon. It 
will give you information including the type of object it 
is, its size or how full it is and whether it is a disk that 
is copy protected or changeable, or a program or 
drawer that is deletable. It is also used to change 
default directories for certain programs, such as the 
Notepad. Discard allows you to delete drawers, tools 
and files. Simply select the appropriate icon and 
choose Discard. You will be warned that you can't get 
bach again what you discard. 

Disk Menu Options 

Empty Trash is used in conjunction with the Trashcan 
icon. It is another approach, besides Discard, to delet- 
ing things. When you drag an icon over the Trashcan 
icon or into its open window, you have essentially 
thrown the item into the garbage can, but you haven't 
"taken the trash out yet," i.e., it is still retrievable. You 
can open the Trashcan window and snatch out any- 
thing that's currently in there. If you want to discard 
the contents of the Trashcan, select the Trashcan icon 
and choose Empty Trash. You can discard a bunch of 
things at once this way. Remember, once you choose 
Empty Trash, the things in the can are forever 
gone — recycled back into available memory. Initialize 
must be used before you can store information on a 
new blank disk. Initializing a disk is described in the 
section below on Disk Operations. 

Special Menu Options 

Clean Up is used for organizing the contents of draw- 
ers. When a drawer h first opened, if you select Clean 
Up, all the icons in it will be put in nice neat rows. 
(Now you see why short names are preferrable.) Once 
your window is all in order, you can save the arrange- 
ment with Snapshot. Here's how: While holding the 
Shift key down, select all the icons you want to save in 
their positions. After they are all highlighted, go to the 
menu and choose Snapshot: After a little disk activity, 
they will stay the way you want them. Of course, you 
will often want to arrange icons separately — exactly 
where you want them — before taking a Snapshot,^ 
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PROTO-5K 

ACDA-BTC PR0-5K ANALOG TO DIGITAL 
CONVERTER AND DIGI-SCOPE SOFTWARE. 

The ACDA-BTC Proto-5K is a versatile Analog to Digital Converter, 
specifically designed to exploit the sophisticated data acquisition 
capabilities of the Amiga Computer. 

1 Single channel, configured specifically for the Amiga's parallel 
port. 

2. 5.882 samples per second minimum throughput. 

3. Hardware Features: 

A. Selectable input gain ol xt and xlOO. 

B. Output range test and calibration circuitry. 

C. Linear ba/graph input level display. 
0. Access indicator. 

E. No external power source required, entirely supplied by host 
Amiga, 

F. Daisy-chained printer connection port. 
G- Parallel port cable to host Amiga. 

H. Attractive practical molded housing case, 

4. Specifications: 

Resolution: 8 bits 

Total error: + - % LSB 

Throughput rate: 6.8 KHz lyp. 

Clock frequency: 500 KHz typ. 

A/D conversion lime: 146 usee max. 

A/0 conversion algorithm: successive approximation 

Input range: - 10 V 

Gain range: input disable, x1, xtOO 

Input impedance: 10 kilohms 

DC Common-mode rejection: + - 'fa LSB (FSR) typ. 

5. Software Features: 

A. Complete data acquisition software package. 

—Full Menu-driven graphics display program. 

—Digital oscilloscope roulines. 

—Data acquisition and test utility program. 

B. Complete programming information. 

—Includes C source code and all documentation. 
—Applications suggestions and documentation. 

POSSIBLE APPLICATIONS 

Biofeedback. 

Digital imaging. 

Environmental monitoring. 

Security monitoring. 

Remote data collection operations. 

voice digitization. 

Quantitative measurement and diagnostics. 
Your Amiga A1000/20Q0 computer is a sophisticated data acqui- 
sition device, USE it that way with the ACDA-BTC Proto-5K!l 

Suggested Lurt Price: $279.00. 
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PROTO-4BK 

ACOA PR0TO40K ANALOG TO DIGITAL CONVERTER 
AND DIGI-SCOPE SOFTWARE SPECIFICATIONS 

The ACDA ProtcMiOK unit is a fast 16-channel real world interface, 

designed to exploit the data acquisition capabilities of the Amiga 

computer. 

1. Hardware Specifications: 

A. 16 Single-ended or 8 differential input channels, expandable 
to 64 SE or 32 Dl. 

B Bipolar, wide input level (10 mV - 10V) range, wilh gain- 
programmable instrumentation amplifier. 

C. 40.000 samples per second throughput. 

O. Sequential or random mode channel addressing. 

E. Specifications: 
Dynamic Accuracy 

Resolution: 12 bits 

Linearity: + - 'i LSB 

Differential linearity: * - % LSB 

Inherent quantizing error: + - fe LSB 

System accuracy: + - 0.03% FSH (G = 1), 

+ - 0.10% FSR (G = 1000) 
Channel acquisition lime: 15 usee 

A/0 conversion time: 10 usee 

Throughput rate: 40KHz 

S/H aperture uncertainty: 10 nsec 

S/H aperture delay: 50 nsec 

S/H feedthrough attenuation: 80 dB @ 1KHz 
S/H droop rate: 0.1 mWmsec 

Channel cross talk: 80 dB @ 1KHz 

CMRR © 60 Hz, 1 kilohm unb.:B0 dB (G = 1). 

100 dB (G = 1000| 

Analog Characteristics. 
Input range: + - 10 mV to * - 10 V 

Gain range: 1 lo 1000 

Input impedance: 100 Megohms: 100 pF 

Bias current: + - 20 nA 

Common mode inpul voltage: + - 11 V (max) 
Amplifier inpul noise: 2.0 uV rms, 4.0 pA rms 

Amplifier output noise: 0.32 mV rms 

(G ■ 100. R = 100 ohms) 
Channel-channel Inpul error: + - 5 uV 

Temperature Characteristics. 
A/D zero drift: t - 10 ppm/°C FSR 

Amplifier zero drift: + - 20uV/*C 

+ -(3uV/°C • Gain) 
Gain drift: + - 30 ppm/°C FSR 

Differential linearity drift: + - Sppm/^C FSR 

F. Immediate connection to Amiga bus expansion port. Bus- 
transparent achitecture permits compatibility with additional 
expansion port peripheral devices. 



G. Integral power supply. 
2. Software Features: 

A. Complete data acquisition software package. 
— Full Menu-driven graphics display program. 
— Digital oscilloscope routines. 
— Data acquisition and test utility program. 

B. Complete programming information. 
—Includes C source code and all documentation. 
— Applications suggestions and documentation. 

POSSIBLE MULTICHANNEL APPLICATIONS: 

Medical diagnostics and biofeedback. 

Electroencephalography (EEG). 

Electromyography (EMB). 

Electrocardiography (EKG). 

Electroocutography (EOG). 

Galvanic skin response (GSR). 

Cortical evoked potentials (sensory and motor). 

Brainstem evoked potentials (sensory). 

Conduction velocity testing. 

Digital imaging. 

Environmental monitoring. 

Security monitoring. 

Remote data collection operations. 

Full sound digitization capability. 

Quantitative analogy measurement. 
Your Amiga A1000/2000 computer is a sophisticated data acqui- 
sition device. USE it that way with the ACDA Proio-40KI 

Suggested List Price: $1795.00. 
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Amiga View : 

AmigaView is a linkable object module library thai contains 
macros for all Intuition and low-level graphics routines. Use of this 
software can reduce a programmer's time and code space by as 
much as 75%. Any CManguage programmer without previous ex- 
perience programming the Amiga, can immediately take full ad- 
vantage of all the graphics goodies and the sophistication that the 
Amiga system has lo offer without specific training on the Intuition 
software system. 

The following is a partial listing of features covered by the 
AmigaView interface software: 
•All screen formats (any resolution mode and bitmap type). 

• All window formats (any resolution mode and bitmap type). 

• All gadget types (including selectable automatic mutual 
exclusion!). 

• All menu types and features. 

• AJI message handling (include handling of multi-input messages 
from many windows and screens simultaneously), 

• All text rendering and font usage and display. 

• All image rendering. 

• All Border rendering. 

• All low4evel exec drawing roulines. 



As an example of the power provided by the AmigaView inter* 
face, onty fifteen lines of C code are required to open a screen 
and window, create and use six gadgets of any type, create a 
menu system with several menus, items and subitems and set up 
a "forever" processing dispatch loop. Any experienced program- 
mer knows that such programming on the Amiga would require 
many pages of code to accomplish the same thing. 

Additionally, we inlcudo an image composition tool called 
■'ImageToor which the programmer would use to produce a multi- 
colored image of any size, depth, and resolution. The ImageTcof 
is a drawing program that outputs C code files to be used in the 
programmer's application code. 

Macros add no overhead to your code, AmigaView being no 
exception adds no overhead to your program. II time and efficient 
use of resources is a concern of yours and your desire is to 
produce professionaify pofished programs, you will want to use 
AmigaView in your development projects. 

Suggested Retail Price: $79.95. Dealer Discount 25tt, 



Ani&a, Intuition tradenarks Corwode Inc. 

AniaaViewj Proto5K,49K trade nark of ACDA Corporation. 



Order Info: 

Specify A10B0/2808 Confix, 

RCDH CORPORATION 

220 Belle Meade Rv 

East Setauket, NV H733 
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Three swaps 
is a nuisance; 
12 swaps 
is torture! 



instead of choosing Clean Up. If you want to save the 
location of a disk icon on the screen, select it and 
choose Snapshot. To save the size a disk window opens 
to as well as the organization of its inside icons, open 
the window, Clean Up or arrange the icons, select all 
the inside icons and the disk icon, then pick Snapshot. 
This also applies to drawer windows; if you select a 
drawer icon along with the icons in its open window, 
the window will henceforth open at that size. 

Sometimes you will notice error numbers in Cancel/ 
Retry requesters or the menu bar. Last Error will dis- 
play, in the menu bar, the last error you made (on the 
Amiga, that is!), if you want to refresh your memory. 
Redraw will redraw the present screen if some Work- 
bench program bug or failure has corrupted the screen 
display. (I have never had to use this feature; my 
crashes always require stronger medicine.) Finally, Ver- 
sion simply displays in the menu bar the versions 
of Kickstart and Workbench in use by the Amiga at 
that time. 



Disk Operations 

Workbench gives you two ways to copy a disk. The 
first is in the Workbench menu on the menu bar and 
involves making a copy using one drive only. Select the 
icon of the disk that you want to copy and then choose 
Duplicate. (This can be done from an external drive, as 
well as the internal one.) Duplicate will copy the disk in 
stages, requiring you to swap the To and From disks. 
When you insert the From disk, the Amiga will "read" a 
section of the disk into memory and then ask you to 
place the disk to copy to in the drive. It then "writes" 
the copied section to the disk and prompts you to 
repeat the process — as many times as it takes, depend- 
ing on the memory your Amiga has available. (With 
51 2K, usually three swaps are required; with only 256K, 
as many as 12 swaps can be necessary if you have other 
things taking up memory space. Three swaps is a nuis- 
ance; 12 swaps is torture! No Amiga should be without 
at least 512K.) The Diskcopy icon in the System drawer, 
you will notice, simply tells you to go to this menu 
selection to make a copy. 

The second method for copying involves two drives. 
This is done by dragging the icon of the disk you want 
to copy over the icon of a disk you want to copy onto. 
The disk you are copying to, of course, will be totally 
overwritten. The Amiga will tell you where to place the 
To and From disks. This is so easy to do, it's a great 
argument for having two drives. 

New disks must be Initialized, or formatted, before 
you can store anything on them. This process also will 
erase the data on a disk and prepare it to receive new 
data. Initialize is in the Disk menu. To initialize a disk, 
select the disk and choose initialize. You will be warned 
that "all data will be erased," and if you select Con- 
tinue, the disk will be formatted. Make sure you wait 
until this process is completed before taking a disk out. 
The newly formatted disk will be named "Empty"; use 
Rename to name it. It will also already have a Trashcan 
on it; Trashcans are put there automatically and cannot 



be deleted. If you select the Format icon in the System 
drawer it will tell you to go to this menu selection to do 
this. An Empty drawer from another disk can be moved 
onto the empty disk and duplicated for new places to 
store things. 

One final note about disks: Never, never, never 
remove a disk or press the disk ejection button when 
the disk drive activity light is on. You can scramble the 
disk this way and make it unreadable; your only hope 
will be the Diskdoctor program accessed through the 
CLI (see the article on p. 16) or a third-party disk 
repair program. Always wait until the light is out and 
then wait some more. Or wait until the pointer on the 
screen returns to its normal form. 

Workbench Tools 

In addition to the functions performed by its menus, 
Workbench contains many tools that make it easier for 
you to work with your Amiga. The most important of 
these is Preferences. You use Preferences to configure 
your system. For instance, you can choose between a 60- 
column display and an 80-column one, tell the system 
what kind of printer you have and where it is attached, 
and even set the colors of your Workbench display. 
Other functions performed by Preferences include acti- 
vating the CLI, configuring your serial port, and edit- 
ing your Workbench pointer. 

You can also use Preferences to set the internal clock 
built into your Amiga. You can then read the clock 
using the Clock tool. The Menu provided with the 
Clock lets you choose between a traditional clock and a 
digital one. 

Other important tools are found in some of the stan- 
dard Workbench drawers, specifically the System and 
Utilities drawers. In addition to the Format and Disk- 
copy tools mentioned earlier, the System drawer con- 
tains Say, a speech synthesis program; SetMap, a 
program that lets you change the language of your key- 
board; a screen-printing program called GraphicDump, 
and the Icon Editor (see the sidebar on page 76). If 
you've activated the CLI from Preferences, the System 
drawer will also contain the CLI tool. 

In the Utilities drawer you have the Calculator and 
the Notepad. The Notepad is especially interesting 
because it is in effect a miniature word processor. 
Using it, you can create and print documents that use 
multiple fonts and type styles. Notepad is one of the 
more interesting Workbench tools. 

Closing Up Shop 

The Workbench with its tools is a very handy place 
indeed to do your work or start your work from. The 
Workbench makes things easy to find and use and 
allows you to decide your own approach to your work. 
Putting the tools to practical and creative use will prove 
to you, over and over, the sophistication of the Amiga, 
the power and practicality of multitasking, and the dif- 
ference in just doing work on a computer and doing 
work on an Amiga with style. The next time you've got 
a job to do, clear a space on your Workbench. ■ 
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Executive Control: 

Introduction to the Amiga's Kernel 

Behind the Amiga's multitasking software, flexibility and ease 
is a group of complex and powerful low-level routines — the Exec. 
This article is about learning to use the Exec's functions. 



A 



By David T. McClellan 

migaDOS is one of the most powerful microcomputer 
operating systems outside of Unix. And unlike Unix, it 
runs well on floppies. AmigaDOS is built on top of 
both sophisticated hardware and a workhorse of a ker- 
nel, known as the Exec. (These are the core system-soft- 
ware routines that control the major functions of the 
computer.) The user-callable AmigaDOS functions, the 
CLI and Intuition are built on top of Exec functions 
(file inputVoutput, for example, uses the Exec trackdisk 
device handler). In this article, I cover mainly the Exec 
functions, rather than higher-level AmigaDOS routines; 
I will discuss these functions from the point of data 
structures and routines that the Exec provides, and will 
show how you can use them. 

AmigaDOS is a multitasking operating system, run- 
ning on top of the multitasking Exec kernel. This com- 
plicates the Exec's job enormously over what a single- 
task operating system, such as MS-DOS, has to worry 
about. At any time, several programs may be contend- 
ing for the same resources: CPU time, devices, memory 
and user-interaction. The Exec has to manage these de- 
mands without letting them step all over each other. 

To create a separate task at the CLI level, you use the 
Run command. When this is done, the program starts 
and the CLI returns for another command while the 
program is still running; it does not wait until the pro- 
gram terminates. A user program in C or another lan- 
guage can do this as well, although it takes a little more 
work. In the following discussion, I'll describe things 
from the point of view of C; all the data structures I'll 
use are C structs or struct pointers. First, let me de- 
scribe tasks and how they differ from processes. 

Tasks and Processes 

To the Exec, a task is a piece of code in memory, with a 
known entry point, its own stack and a task control 



block describing it linked into the kernel's list of tasks 
(more on lists in a bit). It can be alone, or part of a 
single loaded program that sets up parts of itself (sub- 
routines) as separate, independently executing tasks. 
However, tasks that are part of another program can 
onlv call on Exec-level functions; only the main pro- 
gram should call AmigaDOS-level functions and do I/O 
with AmigaDOS devices. 

A process is a task with extras: a memory space and 
process context separate from any other running pro- 
gram. It is typically loaded by another program (such as 
the CLI) and started up as a process with AmigaDOS 
functions. A process can contain several tasks. What the 
Run command creates is actually a separate process. 
AmigaDOS handles processes and their requests; the 
Exec handles tasks. 

To create and start up a task, a program must allo- 
cate and initialize a task struct (described in the exec/ 
tasks.h include file), allocate stack space for the task, 
and call the Exec routine AddTaskfj with the task struct, 
the address of the entry point of the code, and the ad- 
dress of a termination routine for the task if one exists 
(this can be Null). This call will link the new task in 
with the Exec's current list of tasks, and start up the 
code. When done, the new task will terminate and de- 
lete itself; the program that started it must free the 
stack space and the task struct. The new task and its 
parent can communicate via signals and message pass- 
ing, which I'll discuss later. 

Besides its own stack and entry point, each task has a 
priority, and may have a name. The Exec uses a task's 
priority to put the task in the proper place on the task 
list, to schedule how much Amiga time it gets in rela- 
tion to other tasks. The Exec also keeps a variety of 
other lists, and so has a generalized list structure and 
routines to manage lists for the kernel and user pro- 
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grams. Each item on such a list is called a Node. The 
following example shows the Node struct as defined in 
the include file exec/nodes.h: 

struct Node ( 

struct Node *ln_Succ; /* Ptr to next Node in list */ 
struct Node *ln_Pred; /* Ptr to previous Node */ 
UBYTF. ln_Type; /* Type of Node; the Exec */ 

/* supports several and */ 

f* you can define more. */ 
BYTE ln_Pri; /* Priority, -128 to 127 */ 
char *ln_Name; /* Name of Node, can be */ 

/* NU LI.. */ 
i; 

Every list node lias the above standard node header 
and an arbitrarily-sized area tacked on after it for var- 
ious kinds of data. What conies after the header is up 
to the Exec and you; for the task list, it is the rest of die 
task structure. Tasks and processes can do more when 
they can communicate with each other. Inter-task com- 
munication allows the programmer to separate inde- 
pendent parts of an application, which can be run 
alone, reducing overhead in the main application. Ex- 
amples are device "watchdogs," which alert the main 
application program when device events occur, and 
server tasks, which perform common functions for sev- 
eral user programs. A program using a server makes a 
request and then goes on about its business while the 
server does the request. Multiuser database systems like 
CO do this to gate access to the database. The program 
in Listing 1, tlogger.c, is an example of a server task. 

Signals, Messages and Ports 

Tasks can communicate in one of two ways: simple sta- 
tus information via the task "signal" mechanism, and 
more complicated communications containing arbitrary 
data with messages. Each task is allowed up to 32 sig- 
nals, 16 of which are usually used by the system, the 
others available for users. A program wishing to allo- 
cate a signal calls AllocSignal(), requesting a specific 
signal number (which it may or may not be able to get), 
or more usually requesting any available signal by call- 
ing AIlocSignalQ with - 1. The program can then let 
other tasks or the Exec know what the signal bit is, 
make requests and wait for receipt of the signal, via 
Wait(), for the requests to be done. The single argument 
to Wait() is the signal's bit number; Wail() can wait for 
several signals joined together in its argument, as in: 

Wail (phone_sig | toaster_sig | doorbelLsig); 

To allow tasks to pass back and forth more informa- 
tion than the simple yes/no of a signal, the Amiga Exec 
provides "message passing," a mechanism whereby a 
program sets up a message struct, tells the kernel to 
pass that struct to another program waiting for it, and 
waits for a reply. The receiving program doesn't have 
to be concerned with where the message came from, 
only its contents; the sender does not have to worry 
about how to alert the receiver (Exec will do that). The 
mechanisms are simple; they provide the basis of com- 
munication for the three small programs I wrote to 
demonstrate things in this article.^ 
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A program wishing to receive messages must set up a 
message "port," which it names with a name known to 
programs that will send it messages. The CreatePort() 
function allocates and initializes a port, and returns a 
pointer to the port for the caller to use with WaitPort() 
when waiting for messages. Message ports are kept on 
Exec lists, so CreatePort() takes a name and a priority 
as arguments, allocates memory for the port, fills in the 
node header with its arguments and adds the port to 
the appropriate list (public or private, depending on 
whether the name is non-null). Senders get the Exec ad- 
dress for a public port by calling FindPortQ with the 
name of the port and getting an address in return. 
Senders set up message ports for the receiver's reply, 
similar to having a telephone at each end of a phone 
conversation. The reply port can be public or private; 
in my examples they are private. 

A message is a three-part data structure, the first two 
parts of which are common across all messages. The 
first part is a list Node header; the second part contains 
the reply port address for the message and the length 
of the third part. The third part of the message can be 
any data structure desired, so long as senders and re- 
ceivers agree on it. See the TlogMsg struct in file 
ttogger.h in Listing 4 for an example. 

The basic sequence of calls for a receiver is: 

myport = CreatePort (name, priority); 

WailPort (myport); 

nextmsg = GetMsg (myport); 

/* Process the message ... then */ 

ReplyMsg (nextmsg); 

j* Go back and do it again... */ 

/'* When done receiving messages, do */ 

DeletePort (myport); 

The sender, on the other hand, docs this: 

I* Fill in the message ... then */ 
PutMsg (mymsg); 
Wait Port (reply port); 

/* Now go on and do other things ... */ 

Input and Output 

Message ports are also used when doing I/O with Exec. 
A program that wants to do Exec-level I/O must set up 
a message port for the I/O device to reply 10 when a 
requested I/O action is complete; this is illustrated in 
fdejoymsg.c in Listing 2. To the Exec, a device is a set of 
well-defined operations that provide access to some 
physical object (disk, timer, gameport, etc.). Each physi- 
cal device has an associated driver that provides the 
standard operations as well as any extra device-specific 
functions required. A device driver may support more 
than one instance, or "unit," of the device. For exam- 
ple, the gameport has two units — the left and right 
mouse/joystick ports. The Amiga has eleven standard 
devices: the timer, the trackdisk (floppy), keyboard, 
gameport, input (keyboard and gameport combined), 
console (input and screen output), audio, narrator 
(speech synthesizer), serial, parallel and the printer de- 
vice. A device can be a combination of other devices, 
or be based on another device. 



To interact with a device, a program must first set up 
a message port, initialize an IOStdReq struct with 
CreateStdIO(), and open the device with OpenDevice. 
Exec devices are named, so to open the gameport de- 
vice for I/O a program would do: 

ioport = CreatePort(NULl., 0); 

iomsg = CreateStdIO (ioport); 

error >- OpenDevice ("gameport. device", unit_number, 
iomsg, 0); 

/* If error is non-zero, the device 
could not be opened for some reason. */ 

After opening an Exec device, the IOStdReq struct is 
used to communicate with the device. The IOStdReq 
struct is essentially an extended message struct — the 
first part is a standard message structure, followed by 
fields used by the I/O subsystem. This allows the I/O 
subsystem to use message passing to communicate with 
your program. According to exec/io.h, it is: 

struct IOStdReq { 

struct Message io_Message; 
struct Device *io_Device; 
struct Unit *io_Unit; 
UWORD io_Com mand; 
UBYTF. io_Flags; 
BYTE io_Error; 
ULONG io_Actual; 
ULONG io_Length; 
APTR io_Data; 
ULONG io_0ffset; 

1; 

The message part and device/unit pointers are set by 
Exec when you call OpenDevice(). The io_C.ommand 
field is used to tell the device which operation to per- 
form when you send it a request with either DoIO(), 
SendlOQ or BeginIO(). The standard I/O commands 
supported by every device are: CMD_R£SET (initialize), 
CMD_READ, CMD_WRITE, CMD_UPDATE (force in- 
ternal buffers to be sent), CMD_CLEAR (clear buffers 
instead of sending), CMD_STOP (halt device), CMD_ 
START (restart stopped device, like a printer) and CMD 
FLUSH (abort all pending I/O requests). I/O requests 
are queued to the device — in a multitasking system this 
is an absolute necessity — so at any one time several may 
be awaiting service by the device handler. A user pro- 
gram can do its I/O in one of two ways: synchronously, 
by queueing an I/O request with DolO(), which will not 
return until the request is done, or asynchronously with 
SendlOQ. which will queue the request and return im- 
mediately. When using SendIO(), the user program 
sends out the request, goes about its business, and ei- 
ther checks on the request's status with ChecklOQ from 
time to time or eventually gets to a point where it can 
wait on the request to finish and then calls WaidOQ. 
BeginIO() operates at a lower level than DoIOQ or 
SendlOQ, requiring more knowledge of the device 
driver to use. Its I/O may be either synchronous or 
asynchronous, depending on the device. 

The standard I/O routines (see "Arrivals and Depar- 
tures: Input, Output and C," page 67) used in C pro- 
gramming, such iisfopenO, print/(),fpuls(), and so on, are 
implemented on top of AmigaDOS file and console I/O 
routines, which in turn are built upon Exec functions. 
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My tutorial programs use a mixture of the C functions 
(for file I/O and communicating error messages) and 
Exec functions for demonstration purposes and for get- 
ting at things C stdio functions can't do. Used with care, 
the three different layers of I/O can all be called within 
the same program. 

Interrupts 

Tasks and device handlers must be able to be inter- 
rupted when certain events happen, such as when a 
physical device has a piece of data that may be lost if 
not grabbed quickly, or when a hardware timer goes 
off. These are like signals in that they communicate 
only status information; they are unlike signals in that a 
program does not Wait() for them, but gets interrupted 
when they happen. There are both hardware interrupts, 
from physical devices, and software interrupts, which 
programs can send. 

When an interrupt occurs, it must be caught and ser- 
viced as quickly as possible; for example, if the serial 
port says a byte is ready, the serial device handler must 
i^rab the byte and store it in a memory buffer or the 
next byte coming along will wipe it out. Interrupts are 
prioritized so that very important ones will be serviced 
before less important ones; the handling of a low-prior- 
ity interrupt can be interrupted by the handler of a 
higher-priority interrupt. When an interrupt server is 
done, the interrupted task(s) continue where they left 
off, A user program can take over handling a given in- 
terrupt if it has to grab data in the fastest way possible. 
To do this, the program must set up an interrupt struct 
with the interrupt number and a pointer to a routine 
that will service the interrupt, and call AddIn(Server{) 
to add the handler to Exec's set of interrupt handlers. 
The routine will be called whenever its interrupt oc- 
curs. When the program as a whole is done, it must call 
RemlntServerO to tell Exec to take over handling that 
interrupt again. 

Memory Allocation 

All these services require memory for data structures, 
allocated as needed. Programs ask Exec to allocate and 
return memory on an "as needed" basis, using 
AlIocMemO and FreeMem(). When you need a chunk of 
memory, call AllocMem() with the amount needed and 
it will return a pointer to the memory; to free it later, 
call FreeMemQ with the pointer and the size of the 
memory chunk. For example, in the tutorial programs I 
allocate memory for my personal message struct (struct 
TlogMsg in file tlogger.h) and later free it with: 

struct TlogMsg *out_msg; 

out_msg = (struct TlogMsg *) 

AllocMem (sizeof(struct TlogMsg), 
MEMF_PUBLTC | MEMF_CLEAR); 

... /* Use out_msg to send messages */ ... 

FreeMem (out_msg, sizeof(struct TlogMsg)); 

If AlIocMemO cannot find a piece of memory big 
enough to fill your request, it will return NULL, so al- 
ways check the pointer you get back. 

AlIocMemO has other features, performed according to 



its second argument (the MEMF_PUBLIC | MEMF_ 
CLEAR in the example). It can allocate "public" mem- 
ory or "chip" memory (the first 51 2K) on request. The 
graphics and audio chips require data structures they 
use, such as bitmaps or screens, to be in chip memory; 
AlIocMemO can guarantee this placement. F'xec will 
take memory anywhere in public space, thus my use of 
the MEMF_PUBLIC bit. AlIocMemO will also zero the 
allocated memory if it is passed the MEMF_CLEAR bit. 

Conclusion 

That's a brief overview of the Exec kernel, a sophisti- 
cated and powerful chunk of software. The one facility 
I have not covered directly is use of the in-memory li- 
braries for graphics, audio, and so on; they have been 
demonstrated (and will continue to be demonstrated) in 
other tutorials in AmigaWorld, and their use is explained 
in detail in the Rom Kernel Manual. The tutorial pro- 
grams contained in the accompanying listing demon- 
strate message passing, device I/O and memory 
allocation, and indirectly show multitasking. The re- 
ceiver/server program is tlogger.c; it operates by allocat- 
ing a public message port, opening a file and then 
waiting for messages, and copying them to a file until 
one of the messages is the word "quit." It then drains 
off any remaining messages and exits. 

The two sender programs, keymsg.c (Listing 3) and 
joymsg.c (Listing 2), interact with the user to get mes- 
sages to send to tiogger (Listing 1). Program joymsg waits 
for button presses on a joystick attached to the right 
(rear) gameport; it will send a message to tiogger for 
each one it gets, and quit after five button presses/re- 
leases. Keymsg uses C's stdio routines to get text from the 
keyboard, which it sends to tiogger. It quits when the 
user enters the word "quit," after first sending that mes- 
sage to tiogger. Include file tlogger.h contains the com- 
mon message struct used by all three programs, and 
various shared #defines. It also contains the instruc- 
tions for running the programs and checking the 
results. 

Modify the programs and use them as you want. The 
Exec is full of functionality; be prepared to make a few 
mistakes (1 did!), and have fun with it. □ 

Address all author correspondence to David C. McClellan, 104 
Chevron Circle, Cary, NC 27511. 

Listing 1. tlogger.c 

/* + 

tlogger.c 
Logs messages addressed to port named in 
tlogger.h to file named in tlogger.h. Used 
in AmigaWorld Exec functions Tutorial. 
D.T. McClellan for AmigaWorld. Jan. 87 
See tlogger.h for running instructions. 

+ */ 



//include <stdio.h> 

//include "tlogger.h" 

/* This defines the data structures used by 
/* the three programs, and incidentally 
/* includes the needed exec .h files. 



*/ 

*/ 
*/ 



Listing continued on p. 86 
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jrdefine TLOG_INIT_MSG"TLOGGER : starting up\n" 

struct MsgPort *in_port; /* tlogger's port */ 
struct TlogMsg *in_msg; 

/* Most recently received message */ 

char local_buf[MAX_MSG_TEXT+l ] • 

/* Local buffer to copy message text into */ 
/* before replying to message and free */ 
/* the caller's message struct. */ 



main { ) 

( 

FILE *logfile; 
UWORD msglen; 

f* Length of text in current message */ 



/* Log file fileptr */ 



/* + 

I Create and Install Port 1 
1 */ 

/* Allocate signal and memory for port */ 

if (<in_port = CreatePort (TLOG_P0RT_N AME , 0)) 
== NULL) 



( /* No room for port */ 
printf ("tlogger: Not enough memory 
to allocate port.W); 
exit (-1 ) ; 
} 



/# + 

| Open Log File| 
+ */ 

if ((logfile = fopen (TLOG_FILE_NAME, "w")) 
-= NULL) 

{ 

DeletePort (in_port); 

printf ("tlogger: Cannot open Log File %s\n". 

TLOG_FILE_NAME) ; 
exit (-2); 
) 

fputs(TLOG_INIT_MSG, logfile); 

/* Put out my init msg */ 



/* 1 

| Loop: Wait for, Reply to, and Log Messages | 
+ */ 



for { 
! 



CMIlCrealive^Microsysiemsl INTRODUCES THE 
XX Kickstart™ Eliminator 

and 
RAM Expansion Kit 

CMI's Kickstart" Eliminator and RAM Expan- 
sion Kit is an easy way for the user to greatly 
increase the versatility of his or her Amiga Per- 
sonal Computer. By installing ROM (Read Only 
Memory) into already existing locations on the 
Amiga motherboard, you eliminate the tedious 
loading of the Kickstart disk on every power- 
up, and vou make available an additional 256K 
of fast RAM. 



Five New Games For The Amiga 

SfumDLP POKER Sanction 

&REETinG TO RUSSIA 




WSflWfTY FUQtf! 



5WOPER 




10110 SW Nimbus #B1, Tigard, OR 97223 (503) 684-9300 

Dealer and Distributor Inquiries Invited 

Installation requires some soldering. 
Kickstart is a trademark of Commodore-Amiga, Inc. Used by permission. 



/* Eternal Loop */ 
(void) WaitPort (in_port)r 



*/ 
*/ 



NULL 



/* Wait for a message to 

/* come along. 

/* It returns a ptr to the 

/* message, but we must 

/* use GetMsg to actually */ 

/* dequeue the message. */ 

while ((in_msg = GetMsg (in port)) 

( 
/* Log the message, reply, check 

for ending message */ 

msglen = in_msg->msghead .mn__Length ; 
strncpy (local_buf, in_msg-> tex t , msglen); 

ReplyMsg ( in_msg) ; 
/* access to its message struct anymore. */ 

f puts( local_buf , logfile); 

if (local_buf [msgIen-2] != '\n') 

/* Make sure each log message has a */ 
/* newline terminator. */ 

fputc C'\n', logfile); 

if (! strnemp (local_buf, TLOG_QUIT_MSG , 
TLOG_QUIT_LEN)) " /* Done * 

goto done_logging ; 
) /* end while GetMsg */ 

) /* end for { ; ;) */ 



/* + 

I Close down Port and Close Log File | 

! */ 

done_logging : 

/* First, drain the port of any later 
waiting messages */ 
while ((in_rasg = GetMsg (in_port)) 1= NULL) 
ReplyMsg (in_msg) ; 

/* Now free the port and allied stuff, 
and close the file */ 

DeletePort (in_port); 

f close (logfile) ; 

exit (0); 
I 
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TJC-OI 

sue 



5 Elmwood St. 
Worcester, MA 01602 



4s> 



SPECIAL 



Orders over $60.°° get a FREE 
Public Domain Disk containing the 
best utilities, graphics, games. 

BUSINESS ACCOUNTING 

Acquisition $209 

BE.S.T $299 

Financial Plus $189 

ISGUR Portfolio $129 

Keep Track General Ledger $299 

MIAMIGA Ledger S60 

Nimbus I Reed. Keeper . . . S149 

CINEMAWARE 

Defender of the Crown $37 

King of Chicago $37 

S.D.I $37 

Sinbad $37 

DATABASE MANAGEMENT 

dBman , $99 

LPD Filer $99 

Omega File $63 

Organize $67 

Softwood File II $67 

SuperBase $99 

LANGUAGES & UTILITIES 

A/CBasic $230 

A/CFortran $230 

Amiga DOS Express $26 

Amiga Assembler $75 

Aztec C Commercial 3.4 . . $350 

Aztec C Developer 3.4 $225 

Aztec C Professional 3.4 169 

CLI Mate $29 

Cross Assembler $69 

Lattice C $125 

True Basic Libraries $39 

Amiga Lisp $140 

Modula 2 Commer $225 

Professional Pak Utlts. ... $149 

Shell $52 

TDI. Modula II Dev. (N.V.) $110 
TDI. Modula II Std. (N.V.) ... $75 

Developer Tool Kit $39 

True Basic $115 

TxEd $30 

Zing $55 

WORD & TEXT PROCESSORS 

Flow, Idea Process $69 

Gold Spell $35 

LPD Writer $99 

Miamiga Word $66 

Paper Clip Elite , $89 

Prowrite $89 

Scribble! 2.0 $65 

VisaWrite $109 



ENTERTAINMENT 

Advent. Const. Kit $28 

Alien $35 

Archon II $35 

Archon $29 

Artie Fox $28 

Auto Duel $35 

Bard's Tale $35 

Borrowed Time $29 

Bridge 4,0 $24 

ChampShip BaseBall $40 

ChampShip BasketBall $32 

Chess Master 2000 $34 

ChampShip FootBall $33 

ChampShip Golf $33 

Deja-Vu $35 

Delta Patrol $20 

Earl Weaver Baseball $37 

Faery Tale $35 

Famous Courses $17 

Financial Time Mach $30 

Grand Slam Tennis $36 

Gueild of Thieves $33 

Hacker II $34 

Hacker $29 

Hally's Project $35 

Hollywood Jink $35 

All Infocom $26 - $36 

King Quest I $35 

King Quest II $35 

King Quest 3 $35 

Leader Board $30 

Little Comp. People $35 

Marble Madness $35 

Mean 18 $30 

Mind Shadow $29 

Monkey Business $20 

Ogre $29 

One On One $28 

The Pawn $30 

Police Quest $29 

Portal $35 

Quizam $29 

Rogue $30 

Shanghai $29 

Skyfox $28 

Space Quest $35 

Star Fleet I $40 

Strip Poker $30 

Tass Times Tone Town $29 

Temple of Aphsai $30 

Tenth Frame $30 

Tournament Disk $17 

Utltima IV Avatar $42 

Utlima III $44 

Uninvited (New) $39 

Video Vegas $27 

Winter Games $30 

World Games $30 



COPIERS 

Marauder II $29 

Quick Nibble $30 

HOME MANAGEMENT 

2+2 Home Management $65 

Financial CookBook $35 

Home Inventory Mgr $30 

Money Mentor $65 

PHASAR Home Acct Sys. ... $69 
COMMUNICATIONS 

BBS PC $65 

Digital Link $49 

Macro Modem $52 

MaxiComm $37 

OnLine! S46 

TRAINING 

Flight Simulator II $38 

KeyBoard Kadet $30 

Master Type $30 

Silent Service $30 

Super Huey $30 

HARDWARE 

3.5 External Drive $230 

5.25 External Drive $199 

AMIGA 1000 $1275 

AMIGA 2000 $1495 

AMIGA BOARD $375 

ATIME Plus $55 

AVATEX 300/1200 $109 

20-Meg SCSI Hard Drive . $995 

DIGI-VIEW $143 

Future Sound $139 

GENLOCK $240 

AMIGA Modem 1680 $175 

E.C.E. Midi Interface $55 

SIDECAR..... CALL 

StarBoard-2 1 Meg O/K . . . $326 
StarBoard-2 1Meg Popltd. $455 
StarBoard-2 2Meg O/K . . . $356 
StarBoard-2 2Meg Popltd. $585 

StarBoard Multi Funct $89 

StarBoard 2 Upper Deck $45 

XEPEC Hard Disk Dr $895 

EDUCATIONAL 

Discovery Math $29 

Discovery Spell $29 

Discovery Trivia $29 

Donald Duck $22 

Dr. XES $38 

First Shapes $34 

Kid Talk $39 

KINDARAMA $35 

Linkword French $25 

Linkword German $25 

Linkword Italian $25 

Linkword Russian $25 

Linkword Spanish 25 

Math Talk $39 

New Tech Clr Book $27 

Senor Tutor $38 

Speller Bee $39 

Talker $53 

Talking Coloring Book $25 

Winnie the Pooh $21 

A Talk Plus $73 



GRAPHICS & VIDEO 

Animator/Images $99 

Dynamic-Cad $340 

Delux-Paint $49 

Deluxe Paint II $99 

DPAINT ART DISK $25 

DPAINT Art #2 $25 

DPrint Art Disk $25 

Deluxe Print $69 

AEGIS Draw Plus $175 

Delux Video $69 

Images $29 

Impact $125 

SPREADSHEETS 

Analyze! 2.0 $100 

BTS The Spreadsheet $49 

LOGiSTiX. Integrate $125 

LPD Planer $99 

MaxiPlan (new) $109 

MaxiPlan Plus (N.V.) $139 

VIP Professional 129 

SOUND & MUSIC 

Inst-Music Data disk #1 $25 

Deluxe Music $69 

Instant Music $35 

Music Studio $45 

Pro Studio $134 

Sonix $51 

Sound Sampler $89 

PRINTERS 
Cannon Laser LBP-8A1 . . S2085 

Okimate 20 Interface $80 

Okimate 20 w/interface . . . $225 

Panasonic KX-1 091 1 $345 

Star NP-10 Graph NLQ ... $249 
CREATIVITY & PRODUCTIVITY 

Analytic Art $42 

Art Gallery I $25 

Art Gallery II $25 

D' Buddy $49 

Gizmoz Enhanced $49 

Grabbit $24 

KeyGenie $35 

Print Master Plus $37 

The Surgeon $43 

TV* Text $79 

Zuma Fonts I $25 

Zuma Fonts II $25 

Zuma Fonts III $25 

DISKS 

Sony 3.5 DS/DD $22 

Sony 3.5 SS/DD $15 

ACCESSORIES 

3,5 Disk Label $7 

Jitter Flicker Buster $14 

Modem Cables $17 

Teak Wood 120 Cap $35 

Teak Wood 60W/Lock $31 

Teak Wood 64 Cap $28 

House Pad $12 

Printer Cable $17 

Print Heads $35 

Screen Clean $7 



Product subject to availability. Prices subject to change. 

Shipping Info: C.O.D. Charge only $3.00 par shipping. Wo ship UPS Of ound. Air, and overnight shipping available. For fatter 

delivery sand Cashier Cheek, Money ordar, or usa MastarCard or Vita. Parsons! check, allow 20 days to clear. Company 



purchase orders accepted. Call for prior authorization. Mass, residents add 5% sales tax 
Amiga It a trademark of Commodore-Amiga, Inc. 



Listing 2. joymsg.c 
(* 



joymsg .c 
Send joystick i/o event messages to 
tlogger. Each button press and re- 
lease and timeout is sent as a log 
message to tlogger. 

D.T.McClellan for AraigaWorld. Jan. 87 
See tlogger. h for running instructions. 



linclude "tlogger. h" 
#include <devices/gamepor t . h> 
#include <devices/inputevent .h> 

/* + 

\ Defines | 
+ */ 

/* Joystick i/o timeout - 30 second without a */ 
/* trigger (30 seconds * 60 ticks per second) */ 
#define J0YJTIME0UT 30 * 60 

'/* Message text and lengths. Lengths include 
trailing \0 which C automatically adds. */ 

/* Initialization message */ 

#define J0Y_INIT_MSG "JOYMSG: starting up\n" 

Idefine J0Y_1NIT_LEN 21 

/* Termination message */ 

#define J0Y_QUIT_MSG "JOYMSG: done; see you later\n" 

#define J0Y_QU1T_LEN 33 

/* Button down message */ 



miM<@Mm«. 
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A 1000 Expansion Chassis $699,00 

5 expansion slots 

1 J5 woti powei juppfy 

Zones comoot»OH5 

ri oomTor up to fOu( drives 

Safe flex" Amiga interconnect 

•Hard Disk Controller $300.00 
Two ST506 hard dak dnves 
and two f lopCY disk drives 

RAM Board $799.00 
Two meg ol "zero warf s* ales' 
VLSI cont rotor 
Low noise multi-lover PCS 

Prototyping Card $49.00 

Extender Card $49.00 

VS6K Memory Module $109.00 



Wi Mffl- 



'ETHERNET Controller Card $699.00 

Han perforrncrfCe Standard ana 

Cneapernef connectors 
Side mount ven>on ovaitaye 

'AMIGA NFS $149.00 

Full implementation of 
industirystondorct network 
He systems protocol 

•ARCNET Controller Card $425.00 
Lowcosi 
General purpose 
Side mount version avaitaDle 

'ANH 

Arcnet sattwa-e package 
AH Amiga network 
File snonng/netTaie onnt 



'These products are available for the Amiga A2000. 
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-&AMERISTAR TECHNOLOGIES inc# 



P.O. Box 415 

Hauppauge, N.Y. 11 78B 

(516)7243344 



NY. i 

mlJHtfeJ 

Ethernet i 
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#define BUT_DN_MSG "JOYMSG: button DOWN (closed)\n" 
#define BUT_DN_LEN 30 

/* Button up message */ 

#define BUT_UP_MSG "JOYMSG: button UP (open)\n" 

^define BUT_UP_LEN 26 

/* Timeout message */ 

/(define TIME0UT_MSG "JOYMSG: button timeout\n" 

#define TIME0UT_LEN 24 

/* 1 

I Global Data Structs | 

; *) 

struct InputEvont * joy_io_buf f ; 

/* Buffer for i/o event data */ 
struct IOStdReq *joy_io_msg; 

/* 1/0 Message */ 
struct MsgPort * joy_io_port ; 

/* Gameport i/o rendezvous port */ 
struct MsgPort *out_port; 

/* tlogger's port */ 
struct MsgPort * r e p 1 y_p o r t ; 

/ * Msg reply port */ 
struct TlogMsg *out_msg; 

/* Message to tlogger */ 



I* 



Close Up Shop Flags and Container. These flags 
are set in close_flags by the initialization 
code, and used by the close_up_shop routine to 
determine what needs to be done on termination 
of joymsg. 



*/ 

Listing continued on p. 90 



Attention 

Subscribers 

We occasionally make our mailing list available to 
other companies or organizations with products or ser- 
vices which we feel might be of interest to you. If you 
prefer that your name be deleted from such a list, 
please fill out the coupon below or affix a copy of 
your mailing label and mail it to: 

CW Communications/Peterborough 
AmigaWorld 
PO Box 868 
Farmingdale, NY 11737 



Please delete my name from mailing lists sent to other 
companies or organizations. AmigaWorld 

Name 



Address 



City 



State 



Zip 
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Grcfe 389 on Reader Service card. 



Circle 329 on Reader Service card. 



For A Monthly Disk Filled With 
High-Quality Programs. 



Introducing... 



SOFTWARE DJGEST 

your door to the world of high-quality 
public domain software and shareware 



When you order Software Digest, each month you will receive a floppy disk filled with the best and newest public 
domain programs and shareware, conveniently delivered to your door. At Software Digest, our staff continually 
evaluates hundreds of public domain and shareware programs. We then compile the best, and organize these quality 
programs for nationwide circulation via the monthly disks you will receive. All software we distribute are the winners 
of winners and have proved themselves to be the most useful or entertaining. 

Software Digest distributes almost every type of program you will ever need. The coming disks of Software Digest 
will contain programs such as TEXT PROCESSING PACKAGES, SPELLING CHECKERS, SPREADSHEETS, 
DATABASES, TERMINAL EMULATORS, PLOTTING SOFTWARE (some can generate 3D graphics), 
PROGRAMMING LANGUAGES (C, Lisp, Forth, and more), UTILITIES, PRODUCTIVITY TOOLS, 
SOPHISTICATED DRAWING PACKAGES, ARTWORK, ARCADE GAMES (Some are 3-dimensional; 3D glasses 
required.), BOARD GAMES (such as Othello, Yahtzee, etc.), FUN PROGRAMS, AND JUST ABOUT ANYTHING 
YOU CAN THINK OF. You will receive all these programs, plus any other quality programs that are available in 
the future, through Software Digest's monthly disks. ' . 

Whenever significantly-improved versions of programs are released, Software Digest will deliver them to you as 
soon as possible to keep you up to date. The quality we bring you will definitely surpass your expectations! 

Best of all, the subscription fee is only slightly higher than the cost of the blank disks alone. Why so little? Because 
your payment covers only the service costs: disks, duplication, processing, and packaging. 

You have already invested a great deal in your Amiga. Why not get the most out of it? Just a few dollars per month 
will bring you so much convenience, productivity, opportunity, and fun! 

Remember: the earlier you start your subscription, the sooner you will receive all of these benefits. 

These programs are intended to r __ _., 

be available for all Amiga owners I . 

to use. Here is a totally new 
dimension of quality software 
awaiting you, and it's available at 
a very low cost (only a few dollars I . 
per month). Why not subscribe ;; 
today? I 



Attention, shareware developers! 

If you have developed any high-quality 
programs and would like Software Digest 
to help you distribute them as shareware, 
please contact Software Digest Editorial 
Offices, MIT Branch P.O. Box 315, 
Cambridge, MA 02139. Any, other 
submissions— such as public domain soft- 
ware, artworks, articles, etc.— are wel- 
comed as well. Please submit them to the 
address above. 

Amiga is a registered trademark of Commodore-Amiga, Inc. 



Software Digest Subscription Form 
YES, I would like to order. . . 

□ The current issue of Software Digest 
S8.95 plus SI. 00 for postage and handling. 

□ A half-year subscription, 6 issues ($6.95 per issue) 
S41.70 plus S6.00 for postage and handling. 

□ A full-year subscription, 12 issues ($4.95 per issue) 
S59.40 plus $12.00 for postage and handling. 



Please make check payable to Software Digest and mail it, along with this subscription form, 
to Software Digest, Subscription Service, MIT Branch P.O. Box 315, Cambridge, MA 02139. 

Please allow four to six weeks for delivery. 



Ordering form may be photocopied 



PCLOjr - PCLO - PCLOplus 

Printed Circuit Layout systems for the AMIGA computer 

Not just more PC CAD packages; These programs are REALLY FAST, fully 
interactive, and easy to learn! Designed by PC layout artists and electronic 
engineers. These programs otter the highest performance and best 
selection of features for the typical engineering environment. Our "bug" 
tree software works with the AMIGA'S high-performance hardware to give 
you fast, accurate results. Give us a call today and see how our CAD 
products can make your designs faster, easier, and less expensive to 
create. Be sure to ask about our new Schematic drawing systeml 
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Upwiifd Compnliblo 
Semiautomatic fouling 
Trace Yield 
Auto Dip/Sip/Fingrid 
288' sq. workspace 
Full silkscre&n 
Ultlizes color 
Area relation 
Area inversion 
Gtobnl trace tallowing 
Surface stretch 
HI. HP, Gerber PLolters 
Auto ic pin Identity 
Plotter drive/ SOURCE 
Postprocessor SOURCE 
Fully multitasking 
Corner clp and fill 
\0 area memories 
Fabrication shear linos 
NOT COPY PROTECTED 
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Two lypcs of Aic.iFill 

2 lines between pads 
N-Laycr capability 
Object libraries 

M til 1 1 pie pad types 
Multiple pad sizes 
Block operations 

3 measurement typos 
Layer data swapping 
Magnification (zoom) 
Dot matrix checkprinl 
Supports hatd drives 
Uses 6«lfj by 400 mode 
Workahead capability 
Full UnDo capability 
Very easy to learn 

45 degree turns only 
Menu/Mouse/Key driven 
Show plot corrections 
Full lactory support 



S69.95 (PCLOjr) S199.95 (PCLO) S499.95 (PCLOplus) 

Functional Sample disk $85,00 (Credit towards purchase) 

PCLO/plus/jr (c) SoftCircuits, Inc. / Amiga (c) Commodore, Inc. 

First In A Series 01 Engineering Workstation Products From 

SoftCircuits Inc., 701 NW 13th Street, Suite C-4 

Boca Raton, Florida 33432 (305) 368-7024 
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Tie SURGEON for AMIGA 

-A surgery simulation game with color graphics and 
sound !! 



"w_fc^_ 



Time : 00:00:25 
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Scrub 






The patient Is ready, Doctor. 



Have you ever wanted lo try your hand at being a surgeon? The skill, the 

pressure, the split-second life or death decisions, this program has it all. 

Operate in real time and deal with the complications of the surgery. Keep an eye 

on the EKG monitor and the patient's blood pressure while you ciccrcisc your skill. 

Feel the satisfaction of a successful operation!! 

The SURGEON is also educational!! While performing the surgery you will 

learn the parts of > human body, medical terminologies and the steps involved in 

a surgical operation. 

For more information or for order call.... 

ISM, Inc. 

P.O.Box 247 

Phoenix, Ml) 21131 

I'h: (30D-666-2672 



M*:into»h vcoias alio »™iib]«. Visa and Mastercard accepted 

*jn«ia is a reffstcwod lademark of Commcdore Afraja.lne. 
TNi SURGEON is a rei>l»ed tsJtmafk of ISM.Inc 



Dealer vtwti welcome 

Pik» «0 » 
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from p. 88 

#define CL_REP_P0RT 
Sdefine CL_J0Y_P0RT 
#define CL_0UT_MEM 
fdefine CL_J0Y_STDI0 
trdefine CL_J0Y_DEVICE 
^define CL_GAME_TYPE 
#define CL JOY BUF 



0x0001 
0x0002 
0x0004 
0x0008 
0x0010 
0x0020 
0x0040 



unsigned long close_flags = 0; 

/* Flagword used by initialization */ 
/* and close_up_shop routine. */ 

/* + 

| Called Routines j 
+ */ 

extern struct IOStdReq *CreateStdI0( ) ; 

main( ) 

( 

struct GamePortTrigger button; 
int button_coun t ; 

/* + 

I Open message ports; setup message struct [ 
; */ 

if ((out_port = FindPort (TL0G_P0RT_NAME) ) == NULL) 

printf ("joymsgt Cannot find tlogger's port,\n"); 
exit (-1 > ; 
} 

if ((reply_port = CreatePort (NULL, 0)) == NULL) 



{ 



printf {"joymsg: Cannot allocate reply port\n"); 
c 1 o s e_u p_s h o p ( ) ; 
exit (-2); 



close_flags |= CL_REP_P0RT; 

/* Allocate and init message struct */ 
if (<out_msg = (struct TlogMsg *) AllocHem (sizeof 
(struct TlogMsg), MEMF_CLEAR ] MEMF_PUBLIC) ) 
== NULL) 

{ 

printf ("joymsg: Insufficient memory 

for my message . \n" ) ; 
close_up_shop (); 
exit (-3); 



close_f lags 



CL OUT MEM; 



/* Initialize message invariants */ 
out_msg->msghead ,mn_Node . ln_Type = NT_MESSAGE; 
out_msg->msghead . mn_ReplyPort = reply_port; 



Setup i/o data structs, open gaoeport device ] 



-*/ 



if (( j°y_i°_P° r t = CreatePort (NULL, 0)) == NULL) 

{ 

printf ("joymsg : Could not create 
message port for i/o\n"); 
close_up_shop (); 
exit (-4); 

close_flags |= CL_J0Y_P0RT; 

if ((joy_io_msg = CreateS tdIO( joy_io_por t ) ) == NULL) 
{ /* Setup i/o request block to talk to gameport */ 
print f( "joymsg: Could not set up 
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i/o request block\n"); 

c lose_up_shop (); 

exit(-5) ; 
} 
close_flags |= CL_JOY_STDIO ; 

if C (OpenDev i ce( "gamepor t . device" , 1, 

joy_io_msg, 0)) !- 0) 
( /* Open right game port (number 1) */ 
printf ( " joymsg : Could not open 

gameport device\n"); 
c lose_up_shop (); 
exitC-6) ; 
) 
elose_flags |= CL_JOY_DEVICE ; 

if (joy_io_type (GPCT_ABSJOYSTICK) != 0) 

/* Set ganeport device type to joystick 

printf ("joymsg: Could not set type of right 

gameport\n" ) ; 
c lose_up_shop (); 
exit (-7); 

) 

close_f lags 



*/ 



CL_GAME_TYPE; 



/* Set the button info */ 
joy_io_msg->io_Command - GPD_SETTRIGCER ; 
joy_io_msg->io_Length = 

sizeof ( st ruct GamePortTrigger ) ; 
joy_io_msg->io_Data = (APTR) Sbutton; 
button. gpt_Keys = GPTF_UPKEYS + GPTF_D0WNKEYS ; 
button. gpt_Timeout = JOYJFIMEOUT ; 
button. gpt_XDelta - 100; /* Large moves */ 
button . gpt_YDel ta = 100; 



if (DoI0( joy_io_msg) 



! 



0) 



) 



printf ( "joymsg: Couldn't set 

gameport trigger type\n"): 
close_up_shop ( ) ; 
exit (-8); 



if (( joy_io_buf f = (struct InputEvent *) 

AllocMem (sizeof (struct InputEvent). 
MEMF^CLEAR | MEMF PUBLIC)) == NULL) 
{ 

printf ("joymsg: Couldn't allocate 

input bu f f er\n") ; 
c lose_up_shop (); 
exit (-9) ; 
) 
close_flags |= CL_J0Y_BUF; 

/* . f 

Initial message to tlogger I 



*/ 



strcpy (out_msg->text , J0Y_INIT_MSG ) ; 
out_msg->msghead.mn_Length ■ J0Y_INIT_LEN ; 
PutMsg (out_port, out_msg); 
(void) WaitPort ( repl y_por t ) ; 

/* 

Loop, waiting for 1/0 events and sending messages 
on them to tlogger until button is hit 5 times. 

+ . . */ 

button_count = 0; 

for (;;) 

( 
/* Get one i/o event each Sendio to the gameport */ 
/* We are ignoring joystick movement, available */ 
/* by looking at joy_io_bu f f->i e_X and ie_Y; */ 
/* we just catch button events and timeouts. */ 
joy_io_msg->io_Command = GPD_READEVENT ; 



COMPLETE COMMUNICATIONS 
PACKAGE 

(Modem, Cable & Software] 

Introductory Price 
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or 
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[now shipping] 



$49. 



will check spelling and punctuation. 
File compatibility: 

Textcraft '" Notepad '" Scribble ® ASCII 
ASCII (containing printer codes] 

Features: 

95,000 + word dictionary 

FAST [compiled] - checks over 1000 words per minute 

Custom Dictionaries 

Spell Help 

Multi-Tasking 

Textcraft and Notepad are trademarks of Commodore Amiga. Scribble is a 
trademark of Micro-Systems. Hayes is a trademark of Hayes Communications, 

[BOO] 94S-94QS 



THE OTHER GUYS 

55 North Main Street: [BD1] 753-762C 

II Suite 3D1-D 
P.O. Box H 
Logan, Utah S43S1 

Other Great Software and Hardware available, call or write for a free catalog. 
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Converts C64/C128 Files to the Amiga! 

DISK-2-DISK from Central Coast Software makes it easy and convenient 
to transfer C64/C128 files to and from the Amiga. DISK-2-0ISK programs 
the Amiga model 1020 external 5.25" disk drive to read and write 1541/4040 
and 15701571 disk formats including 1541 "Hippies". You can even format 
a 1541 or 1571 diskette on your Amiga! • DISK-2-DISK converts Commod- 
ore/PET ASCII to AmigaDOS standard ASCII and vice versa. Use DISK-2- 
DISK to transfer word processing text files (such as PaperClip. SpeedScript 
and Pocket Writer) to and from the Amiga for use with popular Amiga word 
processors. • DISK-2-QISK includes a utility to find and flag dialect differ- 
ences between Commodore Basic and Amiga Basic files. • DISK-2-DISK 
includes VALIDATE BAM and CHECK DISK utilities. VALIDATE BAM verifies 
the directory structure of the 1541/1571 diskette. CHECK DISK reads every 
biock of a 1541/1571 diskette to detect diskette errors. • DISK- 2 -DISK 
sells for S49.95 plus S3 shipping and handling. CA residents add 6% sales 
tax. Telephone orders welcome. Dealer inquires invited. 




Central Coast Software ™ 

268 Bowie Drive. Los Osos, CA 93402 805 / 528-4906 

Trademarks: Amiga. AmigaDOS. CoTimodore-Amiga. Inc.. PaperClip. Balteries Induced' Pocket Wriler 
Digital Solutions, Inc.; DISKS-DISK, Central Coast Sollware. 
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Spellcheck program for the Amiga Computer 

• Works with Textcraft. Scribble. Ti Ed. Notepad. PTE & ASCII 

• Contains many powerful features including 

the unique "correel to end" lealure 

i • Checks most files in less than t minute 

• Full mulli-tasking to allow simultaneous 

use with your lavorile word processor 

k • 100, 000 word master dictionary 

• Eitremely easy to use 



^LEXCHECK {lekschek 
7| fast easy to 
fheeker for Amiga 
;qm* prill |kem 
ng alii its pari 
ale, entire. 2. e 
fched 3. rcali; 

ent: total: t 

expert: 
shed: skilled -WT 
plct-ing. I. to make 
■ude all parts of. 2, 

ng to an end: fintsl 
i completui, past par 
fcf compute to fill up, il 
complete* ly, adv. — Ml 
l*tl Ida'te, date, date 
^information from w hie 
erenct-s. or conclusions 
drawn- facts and figui 
i now considered RO 
» use either a plural or 
ilar verb with data: Tj 
i indicate thai our thtor 
, The data (or the 
p been coUcvled [Plura 

ruM.| 

till »^d ■ ma 'Htm (o'te 
| n. development and i 

mechanical equipment i 
L combinalion with autorna*. 

, conlro] systems. It inveT 
fche replacement of machines 

[controlled by human operators 



Lis" hi 



AMIGA 



Complete Data Automation, inc. 

S4795 

561 N. MAIN ST. - YREKA, CA 96097 
Phone: 19161842-3431 



Plus 2.00 shipping & handling 
Calil. res. add 6% sales ax 
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joy_io_msg->io_Data = (APTR) joy_io_buff; 
joy_io_msg->io_Leng th = 

sizeof C st rue t InputEvent); 
joy_io_msg->io_Flags = 0; 

SendIO ( joy_io_msg) ; 

(void) WaitPort ( joy_io_port ) ; 

(void) GetMsg ( joy_io_port ) ; 

if (joy_io_bo£f->le Code == IEC0DE_LBUTT0N } 

1 

strcpy (out_msg->text , BUT_DN_MSG); 

ou t_msg->msghead .mn_Leng t h = BUT DN LEN; 
) 
else if ( joy_io_buf f->ie_Code == 

(IECODE_LBUTTON + 1 ECODE_UP_PREFI X ) ) 
( 

strcpy (out_msg->text, BUT_UP_MSG); 

ou t_msg->msghead . mn L-engt h = BUT UP LEN; 

button_count++; 
) 
else /* Time out */ 

( 

strcpy (out_msg->text , TIMEOUT_MSG ) ; 

ou t_msg->msghead .mn_Lengt h = TIMEOUT LEN; 



PutMsg (out_port, out_msg); 
(void) WaitPort ( reply_por t ) ; 

if ( button_count >= 5) 
break; 
1 

/* + 

I Send final message and quit 
J */ 

strcpy (out_msg->text, JOY_QUIT_MSG) ; 
out_msg->msghead . mn_Length = JOY_QUIT_LEN ; 

PutMsg (out_port, out_msg) ; 
(void) WaitPort ( reply_por t ) ; 

close_up_shop (); 

exit (0); 
} 
close_up_shop () 

/* Close up and deallocate all things */ 

/* allocated/opened. */ 



{ 



if (close_flags & CL_GAHE_TYPE) 

(void) joy_io_type ( GPCT_NOC0NTROLLER) ; 

if (close^flags & CL_JOY_DEVICE) 
CloseDevice( joy_io_msg) ; 

if (close_flags & CL_J0Y_STDIO) 
DeleteStdI0( j o y_i o_m s g ) ; 

if (close_flags & CL_REP_PORT) 
DeletePort ( repl y_port ) ; 

if (close_flags & CL_JOY_P0RT) 
DeletePort ( joy_io_por t ) ; 

if (close_flags & CL_0UT_HEM) 

FreeMem (out_msg, sizeof (struct TlogHsg)) 

if (close_flags & CL_J0Y_BUF) 
FreeMem ( joy_io_buf f , 

sizeof (struct Inpu tEvent ) ) ; 



int 
joy_io_type ( gameport_type) 

/* Set type of device attached to */ 
/* right game port. Used in two */ 
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/* partis of joymsg. */ 

SHORT gamepor t_t y pe ; 
( 

BYTE iobuff; 

joy_io_mag->io_Command = GPD_SETCTYPE ; 
joy_io_msg->io_Length = 1; 
joy_io_msg->io_Data = (APTR) Siobuff; 
iobuff = gamepor t_type ; 

/* Send the set controller type message to the */ 
/* gameport device handler, */ 

SendIO ( joy_io_msg) ; 

WaitPort( joy_io_por t ) ; 
/* Check for errors, return any to caller */ 

GetHsg(joy_io_port) ; 

return ((int) joy_io_msg->io_Er ror ) ; 



) 



Listing 3. keymsg.c 

/* + 

keymsg . c 
Program to read messages from console 
and send them to tlogger to be logged. 
Quits after gets and sends string defined 
by TLOG_QUIT_MSG to tlogger. 
D .T.McClellan for AmigaWorld. Jan. 87 
See tlogger. h for running instructions. 
+ *j 

^include <stdio.h> 

fl include "tlogger. h" 

/* This defines the data structures used by */ 
/* the three programs, and incidentally */ 
/* includes the needed exec .h files. */ 

/* + 

| Defines | 
+ */ 

fldefine KEi_INIT_MSG "KEYMSG starting up\n" 

/* Initial msg */ 
#define KEY_INIT_LEN 20 

/* Length of message include \0 */ 

struct MsgPort *reply__por t ; 

/* Port for tlogger to reply to */ 
struct MsgPort *out_port; 

/* tlogger's port */ 
struct TlogMsg *out_msg; 

/* Message to send */ 

ma in ( ) 



/* + 

Get address of tlogger's port, send 
Startup message to it. 

+_, */ 

if (<out_port = FindPort (TLOG PORT NAME)) -= NULL) 
{ 
printf ("keymsg: Cannot find tlogger's port.W); 
exit (-1); 
} 



if ((reply_port = CreatePort (NULL, 0)) == NULL) 
{ 

printf ("keymsg: Cannot allocate reply port\n"): 

exit (-2); 
) 

/* Allocate and init message struct */ 
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COMMUNICATION 50FTWARE 
AND COMPUSERVE ACCESS TIME 
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Hors d'oeuvres 

Unique applications, tips 
and stuff 



You may be using your Amiga at work, you may be using 
it at home, or you may be using it in the back seat of your 
car, but in some way or other, you are going to be using 
your Amiga in a slightly different way than anyone else You 
are going to be running across little things that will help you 
to do something faster or easier or more elegantly. 

AmigaWortd would like to share those shortcuts, ideas, 
unique applications, programming tips, things to avoid, things 
to try. etc., with everyone, and we'll reward you for your 
efforts with a colorful, appetizing, official AmigaWortd T-shirt. 
(Just remember to tell us your size.) 

Send it m, no matter how outrageous, clever, obvious, 
humorous, subtle, stupid, awesome or bizarre. We will read 
anything, but we won't return it, so keep a copy lor yourself. 
In cases of duplication. T-shirts are awarded on a first come, 
first serve basis 

So. put on your thinking berets and rush those sugges- 
tions to: 

Hors d'oeuvres 
AmigaWortd editorial 
80 Elm Street 
Peterborough, NH 03458 



AMIGA SYSTEM 

Computer 

RBG Color Monitor 

256K RAM Expansion $ 1075.00 

A1010 External 3.5 Drive. 199.00 

Amiga Modem 159.00 

Amiga 2000 1125.00 

Side Car CALL 

Amiga 500 CALL 

Computer Specialties 
112 East Thach 
Auburn, Alabama 36830 
(205) 821-8087 



if {(out_msg = (struct TlogMsg *) AllocMem (sizeof 
(struct TlogMsg), MEMF_CLEAR | rtEMF_PUBLIC) ) 
== NULL) 

{ 

printf ("keymsg: Insufficient memory 
for my message . \n" ) ; 

DeletePort ( repl y_por t ) ; 

exit (-3); 
) 

/* Initial message */ 
ou t_msg->msghead .mn_Node . 1 n_Ty pe = NT_MESSAGE; 
out_msg->msghead . mn_Repl yPor t = reply_port; 

strcpy (out_msg->text, KEY_INIT_MSG ) ; 
out_msg->msghead .mn_Length = KEY_INIT_LEN ; 
PutMsg (out_port, out_msg); 
(void) WaitPort ( reply_por t ) ; 

/* + 

I Loop, reading messages from keyboard, sending 

| them to tlogger, 

+ */ 

for (;;) /* Loop until user types in quit message •/ 

( 

printf ("Next Message > "); 

gets ( o u t_m sg->text) ; 

out_msg->msghead . mn_Length = strlen ( ou t_msg-> tex C ) ; 

PutMsg (out_port, out_msg); 

(void) WaitPort ( reply_por t ) ; 

if (! strncmp(out_msg->text , TLOG_QUIT_MSC , 
TLOG_QUIT_LEN) ) 
break; /* Done! */ 

} /* end for ( ; ; ) */ 

/* + 

I Close up shop | 
+ •/ 

DeletePort ( repl y_port ) ; 
exit (0); 



Listing 4. llogger.h 

/* + 

TLOGGER. H 
Specification of data structures 
and names used in the three programs 
of the Exec tutorial. 

D.T.McClellan for AmigaWorld. Jan. 87 
Running Instructions at End. 
+ */ 

^include "exec/types . h" 
#include " exec/exec. h" 

/* + 

| Defines | 
+ */ 

fdefine TLOG_P0RT_NAME"TLOG . PORT" 

/* Name of tlogger's port, for other */ 
/* programs to send messages to. */ 

#define TLOG_QUIT_MSG"qui t " 

/* Message to enter to keymsg to */ 
/* cause it and tlogger to stop. */ 

#define TL0G_QUIT_LEN4 

/* Length of TLOG_QUIT_MSG. */ 

#define TLOG_FILE_NAME" t log . f i le" 

/* File log messages will be written to */ 

(/define MAX MSG TEXT80 
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/* Maximum length of text part of message. */ 



/* + 

| Data Structures | 
4 */ 

struct TlogHsg ( 

/* Message format used by tlogger & callers 
struct Message msghead; f* Standard header, 
char text[MAX_MSG_TEXT] ; 

/* Buffer space for text of message, 
/* Actual length of text is in 
/* msghead .mn_Length ; usually will 
/* be less than MAX MSG TEXT. 



/* 1 

| Commonly used Routines | 
+■ */ 

struct Task *FindTask(); 

struct MsgPort *Crea tePor t ( ) ; 

struct MsgPort *FindPort(); 

struct TlogMsg *Wai tPor t ( ) ; 

/* Fib a little. It returns a ptr 
/* to a generalized message; it 



*/ 
*/ 

*/ 
*/ 
*/ 
*/ 



/* only cares about the first few byt 



*/ 



y tes . 



' :: / 



struct TlogMsg *GetMsg(); 

/* Same "type" fib as for WaitPort 

APTR AllocMem( ) ; 

/* 

Running Instructions for tlogger, joymsg, and keymsg: 



1) 
2) 
3) 

4) 
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not In 
Have a 
to the 
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re meant to be run from the CLI; 

with a fire button attached 

ar ) joystick por t . 

y on a disk it is ok to write on; 

sume that is DF1: and tlogger, 

sg are on DF1 r as well. 

ing commands to the CLI (commands 

SE, my notes about other things 

lowercase). These will cause 
sg to become "background" tasks, 

the foreground task interacting 

console . 



CD DF1 : 
RUN TLOGGER 
RUN JOYMSG 
(hit the joystick button once or twice before keymsE) 
KEYMSG 

5) Now type in text at the keymsg "Next Message >" 
prompts, hitting a carriage return at the end of 
each message. After 45 seconds or so of not 
hitting the joystick button, depress and release 
it four or five times. After five total presses 
of the button, joymsg will exit (invisibly to 
you). Type some more text in at keymsg prompts. 
When ready to quit, type the word "quit" at one 
prompt (as the first and only four letters of 
that line), keymsg and tlogger will go away. 

6) TYPE TLOG.FILE 

This file contains the text of messages send to 
tlogger. Look at the interspersing of ones send 
from keymsg and from joymsg; look for the button-up, 
button-down, and timeout messages from joymsg (it 
will send a timeout message to tlogger after 30 
seconds of inactive joystick buttons) . 

7) Modify the programs as you want; be careful' 
*/ 



Fruit ][ Friend 



The Amiga utility which reads and writes Apple II 
Doa 3,3 and Prodos disks. Now jou can bring those 
text files home to the Amiga. 

Transfer files to or from the Apple II 

Copy Apple 11 disks in 30 seconds 

Format Dos 3.3 or Prodos disks 

Catalog or display files on screen 

Use Dob 3.3 or Prodos file management commands 

Requires the Amiga 5 1/4 inch Disk Drive 

Fruit] [Friend % 49.95 

Amiga 5 1/4 inch drive % 199.95 

Master Card/Visa/C.O.D. 

Top Disk Software 

7451-1 Timberwall Rd. 

SaugertieB, NY 12477 

(914)246-6401 

Quantity discounts available - Dealer inquiries invited 

AMIGA is 8 trademark of Commodore Business Machines Inc. 
APPLB is a trademark of Apple Computer Inc. 
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AC/FORTRAN™ 



Mainframe quality, fiiil feature ANSI FORTRAN 77 

compiler includes: Debugger, Linker, Ubrary Manager, 
Runtime Library, IEEE math, and C interface. Supports 
Complex numbers, Virtual arrays, Overlays and 

Linking. Not copy protected. $295. 

Version for CSA 68020/68881 Turbo board also available $495. 



AC/BASIC™ 



From the authors of Microft BASIC compiler for. Macintosh, 
comes AC/BASK for the Amiga. Companion compiler to the 
Amiga BASIC interpreter: hits more features and includes 
BLOCK IF, CASE statement, and STATIC keyword extensions 
and executes up to 50s taster. AC/BASIC is the new BASIC 
reference for MC68000 based personal computers. Not copy 
protected. $295. 



absaift 



Scientific/Engineering Software Telephone orders welcome 

4268 N. Woodward. Royal Oak, Ml 48072/(313) 549-7111 

Amifi;i Iratlaitifk lit Qmninlorv Ami|ti Micmsofi trademark ot Microsoft Girp 
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from p. 14 

CLI type: 

COPY DFO: TO DF1: ALL 

This reorganizes the file layout and im- 
proves the directory access times noticeably. 

Noah Sherman 
Olympia, WA 

Changing Disks with One Drive 

When using AmigaDOS and only one 
drive, things don't always work the way you 
might want them to. Especially when you 
have to replace the Workbench disk in the 
drive to load the command. Some 
AmigaDOS commands execute immediately 
once they are loaded, not giving you the 
chance to put the non-Workbench disk you 
wanted to work on back in the drive. Using 
the CD command doesn't work because, 
once loaded from the Workbench disk, it is 
executed instantly. 

I found a way around this that people 
may not have discovered. When issuing one 
of those instant execution commands, I just 
add a space and question mark before 
pressing return, which results in the 



AmigaDOS version of on-line help. This 
will give you the syntax and format of any 
AmigaDOS command (a nice thing to re- 
member for beginners) and also loads the 
command into memory before executing. 
This technique works with any of the 
AmigaDOS commands even if they don't 
have parameters, like the INFO command. 
Just tvpe INFO ? and after the disk swap the 
message none: will appear. Replace the disk 
you want info on and press return, 

I hope this makes things a bit easier for 
all of those other single-drivers like me. 

Shawn Switenky 
Prince Albert, Saskatchewan, Canada 



Startup-Sequences 

Startup Speedup 

I would like to share a nifty little trick 
that will speed the startup-sequence on your 
Workbench disks. Most startup-sequences 
contain a number of ECHO statements that 
display bits of information and instructions. 
Each time the ECHO statement is encoun- 
tered, it must be loaded from disk. This 



slows down execution time significantly. 
The statement ADDBUFFERS DFO: 15 as 
the first statement in your startup-sequence 
will eliminate this slowdown. The statement 
creates a sort of mini-RAM disk that stores 
the last disk access (or as much of it as will 
fit) for instant recall. You don't want to allo- 
cate too much RAM because once allocated, 
there is no way (that I know of) to get the 
RAM back. You can use this trick to allocate 
RAM storage for any drive by changing 
drive numbers in the ADDBUFFERS com- 
mand. However, this command is only avail- 
able under AmigaDOS 1.2. 

I have also found that a foam place mat 
from the dinner table makes an excellent 
and inexpensive mouse pad. 

R.D. Thomas 
Millington, TN 

Date/Time Startup 

I found a way to enter the date and time 
without having to first go into the Prefer- 
ences section. I edited the startup-sequence 
using ED. Change the startup-sequence to 
include the following lines 



ECHO " " 

ECHO "DEFAULT DATE" 



show last 
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SOFTWARE 

ACTIVISION 

Mean 18 ■ 29.96 

Borrowed Time .... ■ 30.34 

Mmnshadow ■ 30.34 

Music Studio ■ 36.25 

Little Computer 
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Shanghai ' 35.59 

Hacker II ■ 39.95 

AEGIS 

Aegis Animator/ 
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Aegis Draw '124.00 

Aegis Images ' 54.00 
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COXMCDORE AMIGA SOFTWARE 
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JUKI 5510 
PRINTER 

with color kit 

*439 



Maxwell 
DISKETTES 

MF2-DD *18 
MD2-DD $ 10 
MD2-HD *20 



PRINTERS 


♦ Color Printers* 


Epson 


Special 


Xerox 


Okidata 


Panasonic 


Juki 



Xebec 20MB 
HARD DISK 

9720 H 

$850 



ACCESSORIES 



Modems 
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Hard Drives 
Monitors 



Memory 
Disk Holders 
More! More! 
More! More! 
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D J 1 L Bird 
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Mirror ■ 34.00 

DISCOVERY SOFTWARE 
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Maurauder II ..... . ■ 35.00 

New Tec Coloring 

Book ' 16.00 

Spelling ' 31.95 
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'SET THE DATE AND TIME." 
" DD-MMM-YY HH:MM" 



error trap 



startup date 
DATE 
ECHO " " 
ECHO 
ECHO 
ECHO " " 
FAILAT 21 
DATE ? 
IF FAIL 
ECHO " " 

ECHO "PLEASE TRY AGAIN." 
ECHO "USE SPACE TO SEPARATE 

DATE AND TIME." 
ECHO " " 
DATE ? 
ENDIF 
DATE 
DATE TO SYSiSILAST-STARTUP-DATE 

; write a File 
ECHO " " 

Having the startup script request the date is 
an idea that has been around for a while, 
but this little sequence is unique in that it 
writes. As AmigaDOS boots up, it gets the 
date of the newest files on the Workbench 
disk. Writing a File when the clock is set 
during startup ensures that the next time 
the date is set, it will be set no earlier than 
the last time you used the computer. The 



file is written to the "s" directory. That it is 
named "LastStartup-Date", even that it ac- 
tually contains the date, makes no differ- 
ence; these arc merely coincidences of 
convenience. 

One benefit of this startup is thai you 
never have to type out the complete dale 
unless you shamelessly ignore your Amiga 
for more than a week. The Date function 
recognizes day names as well as dates, and 
assumes that if you enter "Monday", you 
mean the next Monday. Thus, if you last 
booted on Friday, January 31, H>Hl>, and you 
respond "23:12 Monday" to the date 
prompt, it is just as good as typing 
"23:12:00 03-mar-86", and somewhat easier. 
If you reboot during the day, just type the 
current time. As an aside, Date also recog- 
nizes "today", "yesterday", and "tomorrow". 

Marcus Brooks 
Austin, TX 

Date/Time Sans Prompts 

Many AmigaDOS commands generate 
their own prompts when they expect input. 
For example, the DATE ? command causes 
the prompt TIME.DA TE.TO = VER/K to ap- 
pear on the screen. You can suppress the 
command prompt by using the redirection 



operator > and the NIL device. Thus 
DATE >NIL: ? will send the prompt into 
computer never-never land without generat- 
ing any error conditions. Just be sure to 
place the redirection operator before the 
parameter requester ?. 

Roger he Vine 
Highland Park, IL 

Startup RAM DOS 

If you use the CLI a great deal and have- 
only one disk drive, you can edit the start- 
up-sequence to automatically create a RAM 
DOS for you and then leave you in the CLI 
without calling Workbench. 

First, make a backup copy of your Workbench 
disk!.'! This will enable you to start over in 
the event of a mishap. From the CLI 
prompt, type ED S/STARTUP -SEQUENCE. 
This will call up the editor program where 
you may then change the startup sequence. 
You can use the arrow keys to move around 
in the text; the CTRL and B keys let you 
delete lines. The ECHO command simply 
prints text on the screen so you can custom- 
ize your startup screen to read anything 
you want. (For more information about the 
ED, see "Using the Amiga Editor" in the 
May/June 1986 issue oi Amiga World.) Change >. 
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B.E.S.T. BUSINESS MANAGEMENT 






COMPETITION 



Developed on and for the Amiga . . . 

• is useable, reliable, professional quality soft- 
ware, designed to let you conduct your business, 
your way. 

• is a truly integrated program, incorporating bodt 
Accounting and Business Functions. B.E.S.T, BUSINESS 
MANAGEMENT includes Order Processing, Inventor}' 
and Sendees Management, Accounts Receivable, 
Accounts Payable and General Ledger, 

• is an easy to use, menu driven program, supported 
with an understandable, illustrated, 380 page manual 
and knowledgeable customer support. 

See your Amiga dealer for information, or call 

Bp !V Business Electronics 

• J-/lC7« JLl Software & Technology, Inc. 

P.O. Box 230519 / Tigaid, Oregon 97224 / (503) 684-6655 

1-800-368-BEST 
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the startup-sequence to include the follow- 
ing lines: 

MAKEDIR RAM:C 

COPY C RAM:C 

ASSIGN C: RAM:C 

CD RAM: 
Delete the last two lines of the startup-se- 
quence (LoadWB and endcli >nil) if you do 
not want to enter Workbench after creating 
the R^M DOS. When everything looks the 
way you want it to, press the ESC key, then 
the X key, and then press Return. This will 
save your changes to the disk, replacing the 
original startup-sequence with your new ver- 
sion. (This is why you only want to try this 
on a backup copy of Workbench.) If you 
hopelessly mess things up, press the ESC 
key then the Q key to exit the ED without 
saving changes. 

Now, when you warm or cold start your 
Amiga, the RAM DOS will automatically be 
created for you. For switching back and 
forth between disk "drives" (DFO: and the 
new RAM:), use the CD (change directory) 
command. For example, CD DFO: to get 
back to DFO: or CD RAM: to make the RAM 
disk the default directory. 

Steve Worcester 
Buena Park, CA 



Startup INFO 

Here is a way to use the INFO command 
in your startup-sequence to display, at start- 
up, information about storage space on 
your mounted disks. Add these lines to 
your startup-sequence: 

INFO 
WAIT 5 

The WAIT 5 line simply has the Amiga 
pause five seconds after displaying the in- 
formation before going on with the rest of 
the startup-sequence; you can adjust the 
value to change the delay. This is quicker 
than having to open a CLI window after 
loading Workbench. 

Steve Ehrhart 
Wahiawa, HI 

Auto CLI Window 

I am a fifteen-year-old student living on 
Long Island and I have a tip that might be 
useful for people who like to use both the 
CLI and Workbench. First, make a copy of 
your Workbench as a precaution. From the 
CLI prompt type: 

ED S/STARTUP-SEQUENCE 

then move the cursor down and add the fol- 



lowing line just before the last line (which 
reads ENDCLI >NIL:): 

NEWCLI CON:540/1 50/100/50/CLI 

Press the escape key, then the X key and 
return to save your modified startup-se- 
quence. (If you mess things up hopelessly, 
press Q instead of X to bail out of the edit- 
ing without saving your changes.) 

This command opens a new CLI as a con- 
sole window, which means that you must 
give the X and Y coordinates, the width and 
height of the window-, and a title. The first 
two numbers in my line above (540 and 
150) are the X and Y coordinates, which de- 
termine the placement of the window (in 
this case the lower right of the screen). The 
next two numbers (100 and 50) are the 
width and height of the window; the last 
part (CLI) is the name that you want to ap- 
pear on the title bar of the new window. 
The Workbench screen is in the 640 x 200- 
pixel mode, so consider this if you want to 
change the location of the window; note 
that, in my example, 540+ 100 = 640 (screen 
pixel width), and 150 + 50 = 200 (screen 
pixel height). 

Once you have altered the startup-se- 
quence and rebooted, you will be in Work- 



Get down to some serious fun with Amiga® and carry on a conversation wi 
your computer. He loves to show off his special skills: voice synthesis, outsta 
ing graphics, animation, sound, mouse and menus. He'll challenge you to four 
logic games of increasing difficulty: Memory Test, Battle of Numbers, Pegboard 
and Checkers. The Checkers program is full-featured and includes: 



• Human or computer opponent 

• Eight levels of play against the computer 

• Replay a game and exit replay to 
continue play 

• Take back any or all moves 



• Set up special starting position 

• Save and recall games from disk; 

• List game to printer 

• Menu and function key driven 

• Mouse or keyboard moves 



But this is just the beginning! AH the source code is provided — more than 4,000 
lines of Amiga Basic and nearly 1,000 lines of C. The documentation explains 
how everything works and, along with the program listings, will lead you from 
simple Basic routines to advanced programming techniques such as: 

• Organizing a large-scale program 

• Debugging and error trapping 

• Building a user interface 



• Calling libraries and your own 
routines from Basic 

• Artificial intelligence techniques 



Please rush me Conversation With A Computer with Amiga Basic source code. 
Enclosed please find a check for $34.50 plus $2.50 postage and handling. (Califcr- 
nians please add $2.00 sales tax.) Requires 512K. Dealer inquiries invited. I under 
stand ray program will be shipped by first class mail within 24 hours. 

* Amiga is a trademark of Gtmnodot^ 
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bench, but a small CI. I window will bo 
automatically opened in the lower right of 
the screen. The advantage of this method is 
that you don't have to have quick fingers 
for a CTRL-D, or lots of patience for open- 
ing drawers and windows to get to a CLI. 
And when you want to go back to Work- 
bench from the CLI, you don't have to type 
LOADWB return ENDCLI as you would 
with other variations of startup-sequences. 

Michael Rubino 

Cotnmack, NY 



Advanced CLI 



Alternate Character Sets 

Almost every person who has played 
around with the CLI has seen the alternate 
character set. You hit the wrong key or try 
something new and. . .BOOM! These funny 
looking characters appear instead of the 
normal character set. While fooling around 
the other day, I discovered two very useful 
keystrokes: CTRL O (the letter "O," not the 
number zero) will turn on the normal char- 
acter set and CTRL N will turn on the alter- 
nate character set. So, if you do something 



funny and see the alternate character set 
filling your screen, hit CTRL O and you 
will be back in business. 

John D. Hamilton 
Fresno, CA 

Custom CLI Modes 

From the CLI you can enable the various 
text modes with a few short keystrokes. The 
sequence is simply: 

¥.SC[n\;?i'2;n'im 

where ESC is the escape key, n\ is a num- 
ber for style, ti2 is a number for foreground 
color, n3 is a number for background color, 
and in is the sequence terminator. The fol- 
lowing is a list of values you can use, but be 
aware that if the colors have been changed 
through Preferences, these numbers will 
give different results. 

STYLE 

= Plain Text 

1 = Bold Face 

3 = Italic 

4 = Underline 
7 = Inverse 

FOREGROUND 

30 = Default 

31 = White 



32 = Binary complement color (black 
for the Workbench default colors) 

33 = Red 
BACKGROUND 

40 = Default 

41 = White 

42 = Binary complement color 

43 = Red 

You can also combine styles by entering 
each style number separated by a semi- 
colon. For example 

ESC[I;33;41m 

will give boldface red on white, and 

ESC[l;3;4;31m 

will give boldface underlined italics in 
white. 

Some of you will notice that these are the 
same escape sequences used by the 
printer.dcvice. [The Technical Reference Guide 
in this issue has a complete list of printer se- 
quences.] Since the CON: is treated pretty 
much the same way as the PRT:, some of 
the printer sequences work on the screen as 
well as on paper. 

Aside from being just fun, there are some 
practical uses for these customizing tech- ^- 
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Generator Software for the Amiga 



by 
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JDK IMAGES 



Give your mouse 
something else to do... 

While you get results! 



See your Amiga or Video Dealer or Contact 

PVS Publishing 



^= (503)636-8677 
3800 Botticelli • Suite #40 • Lake Oswego • Oregon 97035 



Pro Video CGI is a trademark of JDK Images. AMIGA is a registered Trademark of Commodore-AMIGA, Inc. 
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SAVE 

OVER $15 

OFF REG. PRICE 

Each disk filled (880K!) with quality 
tested, working Amiga PD programs. 



APDC SPECIAL DISKS 

■ 001 : Graphics and Games Choose this 

disk for a sampling of the very best 
of Amiga PD graphics, games, fun! 
• 002: Amiga Learner This tutorial disk 
introduces you to the CLI, explains 
Amiga DOS commands, includes 
examples of programming the EXEC 
and in C, plus much more! 

■ 005: Amiga Basic The best 

of Amiga Basic PD programs. 

■ 031: Amiga PI) Artwork A superb 

collection of IFF format. Hold & 
Modify, and digitized images. 



GRAPHICS and GAMES 

■ 007; Mandelbrot Two graphics 

generators pius excellent samples. 
' 008: Assorted Games Our personal 
favorite. Hours of absorbing fun. 

■ 009: Graphics and Animations Stars 

and cubes dance before your eyes! 
I Oil: Sounds Make Amiga tails. Hear 

Spock and Darth Vader inside Amiga. 
1013: Interactive Graphics Catch the 

flying balls and draw the Mona Lisa. 



UTILITIES, PROGRAMMING 

i 017: Emacs Editors Current versions 
of GNUEmacs and MicroEmacs. 

I 018: General User Utilities All the 

best useful PD utilities on one disk! 

1 021: Telecommunications The best 
PD communications programs 
with docs. Gel on line now! 

1 025: Programming Languages 

PD versions of Forth and Lisp. 



I Individual disk price: $9 per disk. 
\ 5 disk Special Offer: S29.95 
More than S disks: Add $5.99 per disk. 

Add W Postage/Handing til foreignl. Ca residents add 7^ la*. 
O rder flOW and receive a complimentary diskette library 
| case! (Special Offer order, *nh North American addressrmly'i 
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niques. You can include these escape se- 
quences as part of your file comments. I use 
them in commenting my directory names 
(which I like to keep as short as possible to 
avoide extra typing). When you list your 
files, you can make the ones you chose 
stand out from the others. For example: 

F1LEHOTE. filename COMMENT 
"this file is ESC[lm IMPORTANT! 

ESC[0m" 

prints the word IMPORTANT in boldface 
when listed. Filenote is the DOS command 
to append comments to a file. Since we're 
entering escape sequences and spaces in 
our comment, we need the quotes. It is also 
important to change the text back to nor- 
mal at the end with ESC[0m or everything 
listed after that will have the same style and 
color. 

Jim Davis 
Mies, IL 

Custom Prompts and Echoes 

Both the PROMPT and ECHO commands 
found in the C directory can be modified 
to issue some of the ANSI command charac- 
ters in order to change the displayed text 
both in color and style. By using the same 
techniques mentioned above, you can add 
color to the 1> CLI prompt or anything 
"echoed" to the screen. 

To tell PROMPT or ECHO to accept the 
codes, a template of commands is used. 
This template is: 

CSIstyleforeground; 
bacftgrnundm 

CSI is Control Sequence Introducer, 
which can be ESC [ or in hex IB 5B; for the 
PROMPT and ECHO commands, it is *e. 
The style and color options are listed 
above. These colors will be different if 
changed through Preferences. The m at the 
end is the Command sequence terminator. 
Once the PROMPT and ECHO commands 
have been modified, they stay that way until 
you either change them again or reboot the 
system. To modify the prompt, try some- 
thing like: PROMPT "*e[3;33;41mAn,iga- 
VVorld> *e[0m". You should get an italic 
AmigaWorld> in red on a white background 
prompt with everything you type after it in 
normal white on default blue. To modify 
the ECHO command, try something like: 
ECHO "*e[4;32mHello There *e[0m". You 
should get the underlined words "Hello 
There" printed in black. 

David Morgan 
Robina, Australia 



Pattern Matching 

AmigaDOS does not have an explicit 
wildcard string like the asterisk (*) in MS- 
DOS. However, a wildcard string can be im- 
plemented by using the pattern-matching 
pair U}. In AmigaDOS the ? is the wildcard 
symbol for a single character, while the # 
means match the following pattern multiple 
times. For example, the command: 

COPY DF0:SAM/TEST.#? TO DF1:SAM[ 

would copy all the files that begin with 
TEST, in the SAM directory on the disk in 
drive to the SAM directory on the disk in 
drive 1. However, there is a subtle differ- 
ence between #? and *. Under MS-DOS, the 
period is a delimiter between the file name 
and the suffix, but it is not used the same 
way under AmigaDOS. So, in the previous 
example, all files named TEST with a suffix 
would be copied, but the file TEST itself 
would not be copied, since it was not fol- 
lowed by a period. 

Sam Spear 
Fort Worth, TX 



Programming 

SAY from BASIC 

If you want to use the Say (voice) func- 
tion, the best method is to store the spoken 
text in a sequential data file created with 
the built-in Ed function or any word proces- 
sor that allows an ASCII save. After the file 
is created, add the following lines to your 
Amiga Basic program: 

OPES file name FOR INPUT AS #1 

REM file name CREATED USING ED 
WHILE NOT EOF(l) 
LINE INPUT* 1,A$ 
SAY TRANS LATE$(A$) 
WEND 
CLOSE #1 

You can listen to the spoken text before 
placing it in your program by opening a 
CLI window and typing SAY -Xfile name, 

Karl Dittman 
Salem, MO 

Big BASIC Programs Loader 

This tidbit has been around for awhile, 
but I havn't seen it in any of the magazines 
yet. I'm sure that there are a lot of readers 
like me who do most of their programming 
in BASIC. Many were expecting Workbench 
1.2 to allow more BASIC program space 
than the 25K in 1.1, but that apparently 
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didn't happen. I, for one, couldn't wait. I 
have a program that uses almost 100K, 
which doesn't fit in Amiga Basic unless you 
"trick" it. If you have a program that will 
exceed 25K, first write a "loader" program 
that will increase the available space, and 
then "chain" your main program. For exam- 
ple, the loader program that I use is: 

Clear, 3000 
Clear,100000 

where 100000 bytes are made available 

CHAIN main program name 

This opens the required memory and 
then "carries" it into the main program. 

Russell Strong 
Richmond, TX 

Amiga Basic Joysticks 

While trying to use the joystick functions 
STICK and STRIG in Amiga Basic, I found 
some errors in the documentation (pp. 8- 
143 and 8-144). The manual states that re- 
turn values for the Y directions on both A 
and B joysticks are 1 for the "up" direction 
and - 1 for the "down" direction. Actually 
it is the other way around. A return value 
of 1 means down and a return value of - 1 
means up. The X direction functions are 
described correctly in the manual. 

The STRIG function explanation has two 
mistakes. First, the return value stated for 
"depressed fire button" is 1 when it should 
be —1. Second, the subscripts to acquire 
status from B joystick should read STRIG 
(2) and STRIG (3), not STRIG (0) and 
STRIG (1). 

This was aggravating to figure out, so I 
thought I would share this information with 
others who may want to use these functions 
in their own programs. 

Rob Fallier 

Vidalia, GA 

Clearing Keyboard Buffer in BASIC 

The ability to type ahead on the Amiga is 
usually a good thing to have, but it can sure 
mess up the INKEY$ statement in a BASIC 
program. The following subroutine will 
make sure no old, garbage keypresses are 
mistaken for a response. 

SUB CLEARKEYS STATIC 
FOR X = 1 TO 10 

t$ = INKEY$ 
NEXT X 
ENDSUB 

To use, call it immediately before the IN- 
KEY} statement. Example; 



CALL CLEARKEYS 
WHILE INKEY$ = "": WEND 

Margaret Hettinger 
Lebanon Junction, KY 

Point Finding in Amiga Basic 

Here is a tidbit I wrote that is very useful 
to me as an Amiga Basic programmer. At 
times I need to know the location of spe- 
cific points on the screen. I allow my main 
program to draw objects on the screen, 
then STOP the program and run this little 
routine. Clicking the left-mouse button pro- 
duces the coordinates. This way I can easily 
find the vertices of any object on the 
screen. 

POINTFIND: 

IF MOUSE(O) = 1 THEN 

PRINT MOUSE(l),MOUSE(2) 
END IF 
GOTO POINTFIND 

MOUSE(l) returns the X coordinate and 
MOUSE(2) returns the Y coordinate. 

Jeff Kerschner 

Berwick, ME 

C Compiler Printouts 

I was having difficulty compiling a pro- 
gram in C when I thought how nice it 
would be to have a hard copy of the com- 
piler errors to discuss with other program- 
mers. The command format for Manx's 
Aztec C compiler is: 

cc <-option> filename 

Thinking this chore would be easy, I tried 
to redirect the console output to the printer 
by typing: 

cc filename > prt: 

However, the compiler treated > prt: as a 
parameter, since options can appear either 
before or after the name of the C source 
file that resulted in an error. Due to a quirk 
of the system, prt: should precede compiler 
invocation so that: 

cc > prt: <-option> filename 

will properly compile filename and redirect 
output to the printer and return output to 
the console after compilation is executed. 

Sam Spear 
Fort Worth, TX 

Long Variables in Aztec C 

Having trouble getting your Aztec C pro- 
grams to run correctly? Are you using li- 
brary functions? The problem could bewith *. 
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software and hardware. Advanced updatings, technical 
information, Problem-solving, program exchange (over 50 
disks in our PD library). Buying discount service, etc. 
Send 518.00 US for Membership to: 

AUG 

Box 3761 - Attn: Jay Fortran 

Cherry Hill, HJ 08034 

(609) 667-2526 * Visa/Master - Add Si. 00 
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EPSON 

EX- BOO 

For Your Amiga®! 




EX-BOO 
Dot-Matrix Printer 

■ Prints 300 characters per second printheafl 
speed in draft mode lEtrte 1? CPli 

* 60 characters per second prmtnead speed 
in Near Letler Quality mode 

■ New push-button SelecType II tront control 
panei lets you choose from a combination 
of eighi different typestyles 

■ Automatic Sheet Load eas'Jy and quickly 
■nserts single sheets of paper 

* 8k internal butfe; sloies up to four pages ot 
data at a lime 

* User-inslaHable color option kit adds cotoi 
to text and giaphics 

* Bidirectional pnntmg provides maximum 
throughput performance tor boih texl 
and graphics 

* Built-in Push Tractor Feed assures con- 
venient loading 

* One year warranty 



~4 

Uses JX-SO printer driver. 
EX-800 S449.95 . s & h « 

Amiga Schematics still available —^> 

saasrsa 800 762-5645 

Cardinal Software i484o Build America Dr 
Woodbfidge, va ssisi Info: (703) 491-649-1 

Amiga is a trademark of Commodore-Amiga 
Epson is a trademark ol Seiko E| 
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BUTCHER 




Conversion & Processing 
of Amiga Pictures 

-Change Resolution or Number of 

Bit-planes in a Picture 
-Bar Chart of Color Register Usage 
-Quickly Merge or Blend Pixels of 

One Color into another Color 
-Sort Colors by Number of Pixels 

Per Register or Color Intensity 
-Examine Individual Bit-planeg 
-Manually or Automatically Reduce 
Number of Colora in a Picture 
-Generalized Palette Controls 
-Change Hold and Modify to LO-RES 
-Change LO-RES to Hold and Modify 
-Includes Screening, Edge Mapping, 
Mosalcr Contrast Ccntrol, 
Positive-Negative Reversals, 
Density Slicing, and more 
-Great for Pictures Produced by 

Digitizers and Paint Programs 
-Easy to usej Menu-driven commands 
-Requires 512K RAH 

$37 + $2 shipping & handling 

(VA residents add 3.S* sales tax) 



EAGLE TREE SOFTWARE 

P.O. Box 164 
Hopewell, VA 23S60 
"Sr (804) 452-0623 
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•495 
AMIGA 



FREE 

COLOR MONITOR 




With purchase of Computer 



#1 AMIGA DEALER 
SPECIALIST IN 

HOWE AND BUSINESS COMPUTERS 

612-938-3161 

821 Mam Slreet. Hopkins, MN 



A. TALK 

Communications and Emulation 

. KERMIT - ASCII- XMODEM - 
XMODEM/CRC 

. VT100/VT52/H19/ANSI/TTY 

• Concurrent printing and capture. 
Voice option. CB mode. Script 
language. 20 function keys. 

A. TALK PLUS 

Tektronix 4010/4014 Graphics 
Emulation 

. ALPHA/GRAPH/GIN & enhanced 
graphics POINT PLOT and IN- 
CREMENTAL PLOT. 

. All vector line formats. Screen 
size up to 700 by 440. 

. Four character sizes. Printer sup- 
port. Store screens in D Paint II 
or Aegis Draw format. All A-TALK 
features supported. 

A-TALK lists for $49.95. A-TALK PLUS 
lists for $99.95. Add S2.00 shipping; 
CA residents add 6.5% sales tax. 

Felsina Software 

3175 South Hoover Street, #275 

Los Angeles, CA 90007 

(213) 747-8498 
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Hors d'oeuvres 

Unique applications, tips 
and stuff 

You may be using your Amiga at work, at home, 
or in the back seat of your car, but somehow you'll 
be using it in a unique way. You will discover things 
thai will let you do something faster, easier or more 
elegantly. 

AmigaWorld would like lo share those shortcuts, 
ideas, things to avoid, things to try, etc., with every- 
one, and we'll reward you with a coloriul, appetiz- 
ing, official AmigaWorld T-shirt. (Just remember to 
tell us your size.) 

Send it in, no matter how outrageous, clever, 
humorous or bizarre. We will read anything, but we 
won't return it. so keep a copy for yourselt, In cases 
of duplication. T-shirts are awarded on a first come, 
first serve basis. 

So, put on your thinking berets and rush those 
suggestions to: 

Hors d'oeuvres 
AmigaWorld editorial 
80 Elm Street 
Peterborough, NH 03458 
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variables of the type LONG. Aztec C differs 
from Lattice C in that it's integers are not 
automatically of type LONG. So whenever 
you fill a parameter to a library function 
call with a number (not a variable), the 
compiler assumes you want a SHORT. How- 
ever tiie library function may be expecting 
a LONG. When this occurs, you can easily 
crash the machine or get unexpected re- 
stills. The solution is to put a capital L after 
any number you specify in a function call 
(which forces flic number to be of type 
IONG), or to make a variable fur that pa- 
rameter and declare it to be of type LONG. 

For example, 1 had a hard time getting 
the ScrollRaster function to work until I re- 
alized that I had not defined the parame- 
ters of the function as type LONG: 

ScrollRaster(RPort, 1,0,10, 10,100,100); 
won't work, but 

ScrollRaster(RPort,lL,0L 10L, 10L, 
1001, 100L); will work. 

('heck the Intuition Reference Manual or 
the ROM Kernal Manual whenever you use a 
function to sec if your parameters are of 
the correct type.This is a major reason why 
those Lattice C source Files just don't seem 
to work with A /.tec C. 

Nicholas Barrowman 
Kingston, Ontario, Canada 

Reading Joysticks in C 

For my latest C language project, 1 
needed a way to read the joystick ports. The 
manuals propose a very complicated proce- 
dure, so 1 developed my own. In my rou- 
tine, I step down into the machine and read 
the hardware registers directly. Here is a 
short routine that should run on both Aztec 
and Lattice compilers: 

#define PORT 2 

short *joy = 0xdff008 + 2 * port; 
char*cia = OxbfeOOl; 
mainQ { 
for(;-,) { 

if (*joy & 2) 

printf("RIGHT . . . "); 
if (*joy & 512) 

printfC'LEFT . . . "); 
if((*joy » 1 A *joy)& 1) 

prinlffDOWN . . . "); 
if ((*joy » 1 * *joy) & 256) 

printf("UP .. ."); 
if (!(*cia & 64 * PORT)) 

printfC'FIRE III**); 
printf("\n"); 

} 
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Martin Brenner 

Neu-Ulm, West Germany 



1 02 Special Issue 1981 



iHlThe Pull-Down Menu 



NO SCAN LINES] TOP QUALITY— FAST 

SLIDES 

ANY IFF FILE PROCESSED DIRECTLY FROM YOUR DISK! 

2k resolution 35mm slides $9.30 each. Also digital color separations. 

Now accepting Visa/MC, minimum order $25.00. 

Call or write for our full service list: 

ImageSet— 555 19th St., San Francisco, CA 94107 

(415) 625-8366 



THE DISK SPECIALISTS 
SPECIAL OFFER 



E3HH 



3.5" DSDD, Fujitsu, Bulk, Lifetime Guarantee 

• 50 Disks (1 carton), @ $1.15 per disk • 

Limit 2 cartons per customer. Write/Call for larger quantities, 

other product listings. 

MCP Associates, P.O. Box 6260, LIC, NY 11106 

(718) 956-9000 



"DISNEY" 


STYLE ANIMATION $295 


• Create 3D characters and scenes quickly and easily. 


• Includes shading in 


4096 colors, background matting. 


• Real-time audition. 




• Animation vignettes complete overnight. 




Hash Enterprises 


14201 SE 


16th Circle, Vancouver WA 966S4 




(206) 256-8567 



hate DUSTCOVERS? 

LOVE COVERUP OR MONEY BACKt 
COVERUP attaches with velcro. It flips out of the way while you work, 
but stays handy. COVERUP is made ot non-static fabric. A set (mon- 
itor, CPU, ext. drive) costs $25, order direct from: 

COVERUP (805) 487-1545 

3129 Lassen Street 

Oxnard, CA 93033 
Dealer Inquiry Welcome 



MS MicroEd 



Educational Software K thru ADULT 

SEND FOR A LIST OF OUR 29 AMIGA PROGRAMS. ALL USE 

VOICE. MANY USE DIGITIZED PICTURES. 

MicroEd, Incorporated 

P.O. Box 24750 

Edina, MN 55424 



Tek 4105 and VT100 Emulation 



MiddleMan™ True VT1 ^ 1 9 m ulation. Fully integrated into the Amiga multi-tasking 
. _ environment. TbxI file transfer, macros, 7000 baud tent DISPLAY ratB, 

$59.95 graphics character set, and more. Available since July 1986. 

MiddlGMan M™ A " lne ' ea,ures °t MiddlBMan™ plus Tektronics* 4105 color graphics 
terminal emulation. Available early Fall, 1987, Pre-release copies 
$149.95 available NOW tor $129.95. 

1-800-6 BCP, Inc. In Alabama: (205) 881-1110 TisT && 

Benaiah Computer Products. Inc. P.O. Box 14502 Huntsville, AL 35815 '*' ^^^ 



The Pull-Down Menu 

AMIGAWORLD'S New Pull-Down menu is a great 
opportunity for those with AMIGA products to reach 
over 70,000 Amiga owners. Amiga World is the only 
publication with a subscription card in the box with 
every Amiga computer, national newsstand distri- 
bution by ICD Hearst, and single copy sales in com- 
puter stores carrying the AMIGA as well as large 
bookstores such as B. Dalton and Walden Books. 
To reserve your Pull-Down Menu ad call Heather 
Paquette on the East Coast at 1-800-441-4403 or 
Brenda Billhimer on the West Coast at 1-415-328- 
3471. We accept checks, money orders, MasterCard 
or VISA. 



MEGAmiga 

wait, 2 megabyte ram with own power supply 
and pass through bus for $595 ppd. 

CALL (602) 622-1344 

API, 1620 N. Park Ave, Tuscon AZ 85719 

Dealer Inquires Welcome 



AMIGA T-SHIRTS AND SWEATSHIRTS 

Quality white shirts silk screened with 
Amiga logo in beautiful color. 

T-shirts: S12.00 Sweatshirts: S18.50 

In CA, add 6% tax. 

SEND CHECK OR MONEY ORDER TO: 

T* Me, P.O. Box II 746. Santa Ana, CA 927 11 

2525 Shadow Lake. Sanu Ana. CA 92701 

C*U|7Hi63!W5MS 

Dealer Inquiries Invited 

Amiya is a trademark of < SOBBOdbn -Arnica. Ir 



!'!(■.:■- :■■ allow 3 to 6 
weeks for delivery 
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USE YOUR PHOTOS 

Slides or Drawings with your Amiga 



PROGRAMS, BUSINESS REPORTS, SCHOOL PAPERS and COMPUTER ART 

Images digitized and returned on disk, using standard IFF format. Images cropped untess lull 

frame specified. Satisfaction guaranteed. Send copies; we cannot tie responsible for toss or 

damage of materials. One image— $15; up to four images— S1B; up to seven images— $21; 

each additional image— $2. Add S2 shipping/handling. (CA res. add 6% sales tax. Foreign add 

$4 US) Black and White digitizing Is available for the Commodore 64/128 

Send check or money order (o: 

YORE PHOTO™, Dept. D, PO Box 1269, 29 Palms, CA 92277 

(619) 367-3779 

In a Hurry? Specify 'ZAPISHOT'. Up to seven images will be digitized and in return Express 

Mail within 24 hours of our receipt (Monday-Friday only}. Add $20 special postage and handling. 



AmigaWorld 103 



AmigaWorld is a member of the CW Communica- 
lions/Inc. group, the world's largest publisher of 
computer-related information, The group pub- 
lishes over 80 computer publications in more than 
28 major countries. Fourteen million people read 
one or more of the group's publications each 
month. Members of the CWCI group contribute to 
the CW International News Service offering the latest 
on domestic and international computer news. 
Members of the group include: ARGENTINA'S 
Computerworld/Argenlina, PC Mundo; ASIA'S Com- 
puterworld Hong Kong, Computer-world SE Asia; AUS- 
TRALIA'S Computerworld Australia, Communications 
World, Australian PC World, Australian Macworld; AUS- 
TRIA'S Computerwelt Oesterrekh; BRAZIL'S DataNews. 
PC Mundo, Micro Mundo; CHILE'S Informatica, Com- 
putation Personal; DENMARK'S Computerworld Dan- 
mark, PC World Danmark; FINLAND'S Tietoviikko, 
Mikro; FRANCE'S Le Monde Informatique, Distrib- 
utique, InfoPC, Ijs Monde Des Telecoms; GREECE'S Mi- 
cro and Computer Age; HUNGARY'S Computerworld/ 
SZT, Mikrovilag, Tudomuny; INDIA'S Dataquest; IS- 
RAEL'S People isf Computers Weekly, People (^Computers 
Monthly; ITALY'S Computerworld ' Italia; JAPAN'S Com- 
puterworld Japan; MEXICO'S Computerworld Mexico, 
Compumundo; THE NETHERLANDS' Computerworld 
Netherlands, PC World Netherlands; NEW ZEALAND'S 
Computerworld New Zealand; NORWAY'S Computer- 
world Norge, PC World Norge; PEOPLE'S REPUBLIC 
OF CHINA'S Gotta Computerworld, China Computer- 
world Monthly; SAUDI ARABIA'S Arabian Computer 
News; SOUTH KOREA'S Computerworld Korea, PC 
World Korea; SPAIN'S Computerworld Espana, 
Commodore World, PC World Espana, Comunitaciones 
World, Informatica Industria; SWEDEN'S 
ComputerSweden, Mikrodatarn, PC World; SWITZER- 
LAND'S Computerworld Schweiz; UNITED KING- 
DOM'S Computer News, DEC Today, ICL Today, PC 
Business World, Lotus UK; UNITED STATES' 
AmigaWorld, Boston Computer News, CD-ROM Review, 
Computerworld, Computers in Science, Digital Neius, Fed- 
eral Computer Week, SO Micro, FOCUS Publications, 
inCider, InfoWorld, Mac World, Micro Marketworld, Net- 
work World, PC World, Portable Computer Review, Pub- 
lish!, PC Resource, RUN; VENEZUELA'S 
Computerworld Venezuela; WEST GERMANY'S Cem- 
puterwoche, PC Welt, Run, Information Management, PC 
Woche. 



Manuscripts: Contributions in the form of manu- 
scripts with drawings and/or photographs are wel- 
come and will be considered for possible 
publication. AmigaWorld assumes no responsibility 
for loss or damage lo any material. Please enclose 
a self-addressed, stamped envelope with each sub- 
mission. Payment for the use of any unsolicited 
material will be made upon acceptance. All contri- 
butions and editorial correspondence (typed and 
double-spaced, please) should be directed to 
AmigaWorld Editorial Offices, 80 Elm Street, Peter- 
borough. NH 03458; telephone: 603-924-9471. Ad- 
vertising Inquiries should be directed to 
Advertising Offices, CW Communications/Peter- 
borough, Inc., 80 Elm Street, Peterborough, NH 
03458; telephone: 800-44 14403. Subscription prob- 
lems or address changes: Call 1-800-227-5782 or 
write to AmigaWorld. Subscription Department, PO 
Box 868, Farmingdale, NY 11737. Problems with 
advertisers: Send a description of the problem and 
your current address to: AmigaWorld, 80 Elm Street. 
Peterborough, NH 03458, ATTN.: Cynde Garrett 
Customer Service Manager, or call 1-800-441-4403. 
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a one year subscription to 
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AmigaWorid 
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TO RECEIVE MORE INFORMATION AMIGA 



TEAR 



out the perforated card 

Please print or type your 

name and address where 

indicated. 



CIRCLE 

the numbers on the card 

that correspond to the 

reader service numbers on 

the advertisements that 

interest you. 



ORDER 

a one year subscription to 

AmigaWorld by circling 500 

on the card. 



READER SERVICE 



MAIL 


LOOK FOR 


he card with your check. 


your subscription in 10 to 


money order or U.S. 


12 weeks. 


currency to: 




AmigaWorld 




Reader Service Dept. 




P.O. Box 363 
Dahon, MA 01227 


REMEMBER 


Or, you may request 


to put the proper postage 


billing. 


on the card. 






PLACE 






STAMP 






HERE 



AmigaWorld 

ATTN: Reader Service Dept. 

P.O. Box 363 

Dalton, MA 01227 



PLACE 

STAMP 

HERE 



AmigaWorld 

ATTN: Reader Service Dept. 

P.O. Box 363 

Dalton, MA 01227 



CHARTER 
OFFER 

Save 25% 
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Enter my one year subscription (6 issues) to 
AmigaWorld for the low charter subscription 
price of $14.97. Money back guarantee: If I'm 
not satisfied at any time I will receive a full refund. 



□ Payment Enclosed 

□ Bill Me 



Name 



Address 



City 



State 



Zip 



Please make c^eck payable lo .4tfl^aU6i£l Canada & Mexico $17.97, 1 year only, US 
Funds drawn on US Bank. Foreign Surface J34.97. 1 year only, US Funds drawn on 
US Bank. Foreign Airmail please inquire. Please allow 6-8 weeks for delivery. This 
offer i\ far new subscribers onlvl 

37SB2C 



BUSINESS REPLY MAIL 

Firs! Class Permit No. 73 Peterborough NH 03458 
POSTAGE WILL BE PAID BY ADDRESSEE 



NO POSTAGE 

NECESSARY 

IF MAILED 

IN THE 

UNITED 

STATES 



CW Communications/Peterborough 
AmigaWorld 
PO Box 868 
Farmingdale, NY 11737 
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17408 Chatsworth St., Granada Hills, CA 91344, inside CA 818/360-3715 • outside CA 800/522-2041 • FAX 818/360-1464 




There's a slim difference 

between the ordinary and the 

extraordinary. . . PAL JR. 




• / MByte fast expansion RAM at C00000 

• No wait states 

• 20 MByte hard disk drive 

• True DMA controller with SCSI option 

• Battery backed clock/calendar 

• Open Zorro expansion slot 

• Low profile, Amiga-beige cose 

• User expandable to 9 MBytes RAM 

• Entire system auto-configures 

• Suggested retail price $1,495. 00 



2 MByte 

RAM 

CARD 

• High speed 
memory 
board 

• No wait 
states during access or refresh 

• Incorporates SIMM technology 

• User upgradable to 8 MBytes 




O 



BYTE bu BYTE.. 



Arboretum Plaza II 9442 Capitol of Texas Highway North Suite 150 Austin, TX 78759 (512)343-4357 



Circle 300 on Reader Servce card. 



